home *** CD-ROM | disk | FTP | other *** search
/ ClipArt Heaven 2 / ClipArt Heaven 2.iso / utility / alch162 / alchemy.doc < prev    next >
Text File  |  1993-01-26  |  294KB  |  8,927 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                     Image Alchemy
  10.  
  11.  
  12.                                      Version 1.5
  13.  
  14.  
  15.  
  16.                                   November 11, 1991
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                Handmade Software, Inc.
  43.                            15951 Los Gatos Blvd., Suite 17
  44.                                 Los Gatos, CA  95032
  45.  
  46.                                    +1 408 358-1292
  47.                                  +1 408 356-4143 fax
  48.                                  +1 408 356-3297 BBS
  49.  
  50.                               Internet:  hsi@netcom.COM
  51.                               CompuServe:  71330,3136
  52.  
  53.  
  54.  
  55.  
  56.                        Demonstration Version Information
  57.  
  58.  
  59.           This is a demonstration version of Image Alchemy.  It's fully
  60.           functional except it can not handle images larger than 640 by
  61.           480.
  62.  
  63.           We encourage you to freely copy and distribute the demonstration
  64.           version of Image Alchemy provided that no fee is charged and the
  65.           distribution files are distributed in their original forms.
  66.  
  67.           For the registration fee, you will receive the current, retail
  68.           version of Image Alchemy without the 640 by 480 image size
  69.           restriction and a typeset and printed manual (complete with a
  70.           table of contents and an index).  You will be notified of
  71.           significant upgrades to Image Alchemy, you will be placed on a
  72.           mailing list to receive information about future products from
  73.           Handmade Software, and you will be entitled to phone and email
  74.           support.
  75.  
  76.           For ordering information please see the order form at the end of
  77.           this manual or in the file order.frm.
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.      ii
  111.  
  112.  
  113.  
  114.           Notice           Handmade Software, Inc. makes no warranty of any
  115.                            kind either expressed or implied.  In particular
  116.                            we make no warranty as to merchantability or
  117.                            fitness for a particular purpose.
  118.  
  119.                            In no event shall Handmade Software, Inc. be
  120.                            liable for any errors contained herein or for
  121.                            incidental or consequential damages in
  122.                            connection with the furnishing, performance, or
  123.                            use of the Image Alchemy product or
  124.                            documentation.
  125.  
  126.                            This document contains proprietary information
  127.                            which is protected by copyright.  No part of
  128.                            this document may be photocopied, reproduced, or
  129.                            translated without the prior written consent of
  130.                            Handmade Software, Inc.
  131.  
  132.                            The information in this document is subject to
  133.                            change without notice.
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.                            Copyright (c) 1990-1991 Handmade Software, Inc.
  160.  
  161.                            All Rights Reserved
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     iii
  169.  
  170.  
  171.  
  172.           Author credits
  173.  
  174.             Image Alchemy  Marcos H. Woehrmann
  175.            was written by  Allan N. Hessenflow
  176.                            David Kettmann
  177.  
  178.  
  179.  
  180.           Other credits
  181.  
  182.  
  183.            Marc Schneider  Who provided assistance with the Sun
  184.                            implementation of Image Alchemy including Beta
  185.                            testing and answering questions about the
  186.                            internal format of Sun Raster files.
  187.  
  188.  
  189.  
  190.               Jack, Norm,  Who proofread the manual (any remaining misteaks
  191.           Erwin, and Dave  are because we made changes after they read it
  192.                            for the final time).
  193.  
  194.  
  195.  
  196.             Everyone Else  Who gave us advice and assistance and especially
  197.                            to those people who sent us sample image files.
  198.  
  199.  
  200.  
  201.  
  202.  
  203.           Trademarks       Image Alchemy is a trademark of Handmade
  204.                            Software, Inc.
  205.  
  206.                            All other products or services mentioned in this
  207.                            manual, including: IBM PC, IBM PC AT, 80286,
  208.                            80386, 80486, VGA, 8514/A, Paradise, Everex,
  209.                            Trident, Video 7, Tseng Labs, Western Digital,
  210.                            MS-DOS, PC-DOS, SPARC, Sun, SPARCstation,
  211.                            SPARCserver, SunOS, Targa, PostScript, EPS,
  212.                            Encapsulated PostScript, GIF, ILBM, IFF,
  213.                            Macintosh, Silicon Graphics, SGI, PCX, TIFF,
  214.                            Windows, Windows BitMaP, EGA, PCL, HP, AI, PS/2,
  215.                            HAM, PC Paintbrush, MacBinary, PHIPS, NeXT, C-
  216.                            Cube, Storm Technology, Radius, ColorSqueeze,
  217.                            VFCtool, Amiga, CompuServe, LaserJet, Melior,
  218.                            and Gill Sans are trademarks, registered
  219.                            trademarks, service marks, or registered service
  220.                            marks of their respective companies or
  221.                            organizations.
  222.  
  223.  
  224.  
  225.  
  226.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.      iv
  227.  
  228.  
  229.  
  230.  
  231.  
  232.                                                                           0
  233.  
  234.  
  235.  
  236.           Introduction to Image Alchemy
  237.           -----------------------------------------------------------------          -----------------------------------------------------------------
  238.  
  239.  
  240.           What is Image    Image Alchemy is a software utility that
  241.           Alchemy?         manipulates computer image files.
  242.  
  243.                            The main thing that Image Alchemy does is to
  244.                            convert between various graphics file formats.
  245.                            Image Alchemy can translate between a large
  246.                            variety of file formats including industry
  247.                            standards such as GIF and TIFF and vendor
  248.                            specific file formats such as Sun Raster and
  249.                            Scodl.  Currently Alchemy supports over 30
  250.                            different formats, and new formats are always
  251.                            being added; in fact, our goal is to have Image
  252.                            Alchemy be able to read and write every graphic
  253.                            file in the world.
  254.  
  255.                            Image Alchemy can also make changes in an image.
  256.                            For example, Image Alchemy can re-size an image,
  257.                            change the number of colours in an image, change
  258.                            an image from colour to black and white, and
  259.                            change the colour space an image uses.
  260.  
  261.                            Finally, Image Alchemy performs JPEG
  262.                            compression.  This is a new standard for image
  263.                            compression that can achieve much higher
  264.                            compression ratios than conventional compression
  265.                            techniques.  It achieves this high compression
  266.                            ratio by not entirely preserving the original
  267.                            image (this is referred to as "lossy"
  268.                            compression).  For further information see
  269.                            Appendix C, What is JPEG Compression.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     0-1
  285.  
  286.  
  287.  
  288.           About this       This manual is divided into 8 chapters, 11
  289.           manual           appendices, a glossary, and references.
  290.  
  291.  
  292.                 Chapter 0  Introduction and Conventions
  293.  
  294.                 Chapter 1  Installation Instructions
  295.  
  296.                 Chapter 2  Introduction to Alchemy
  297.  
  298.                 Chapter 3  Output Options
  299.  
  300.                 Chapter 4  General Options
  301.  
  302.                 Chapter 5  Colour and Palette Options
  303.  
  304.                 Chapter 6  Scaling Options
  305.  
  306.                 Chapter 7  Viewing Options
  307.  
  308.                Appendix A  Answers to Frequently Asked Questions
  309.  
  310.                Appendix B  Colour and Dithering
  311.  
  312.                Appendix C  JPEG Description
  313.  
  314.                Appendix D  Customer Support
  315.  
  316.                Appendix E  Binary Information Files (BIF)
  317.  
  318.                Appendix F  HSI Raw Files
  319.  
  320.                Appendix G  Undercolour Removal Files
  321.  
  322.                Appendix H  PAL Files
  323.  
  324.                Appendix I  Version History
  325.  
  326.                Appendix J  Acknowledgements
  327.  
  328.                Appendix K  Other Useful Software
  329.  
  330.                  Glossary
  331.  
  332.                References
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     0-2
  343.  
  344.  
  345.  
  346.           Pathnames        Because the MS-DOS and UNIX operating systems
  347.                            use different conventions for path names users
  348.                            of UNIX will have to substitute forward slashes,
  349.                            "/", for the back slashes, "\", found in the
  350.                            examples in this manual.
  351.  
  352.  
  353.  
  354.           Unintentional    UNIX users should also be aware that the UNIX
  355.           wildcard         shell they are using may be performing wildcard
  356.           expansion        expansion on certain characters (generally "*"
  357.                            and "?").  Since these are options which Alchemy
  358.                            uses they need to be escaped to prevent the
  359.                            wildcard substitution.  This is done by using a
  360.                            back slash, "\", before the character (so -?
  361.                            becomes -\?).
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     0-3
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                                                           1
  407.  
  408.  
  409.  
  410.           Installing Image Alchemy
  411.           -----------------------------------------------------------------          -----------------------------------------------------------------
  412.  
  413.  
  414.           Overview         Installation of Image Alchemy is simple; it
  415.                            involves copying the Alchemy program off of the
  416.                            floppy disk or tape onto your hard drive or
  417.                            network.
  418.  
  419.                            You need to be familiar with the copy command if
  420.                            doing a DOS installation and the tar command if
  421.                            doing a UNIX installation.  If you are not
  422.                            familiar with these commands you may wish to
  423.                            read the manuals which came with your computer
  424.                            or ask someone to assist you.
  425.  
  426.                            The installation instructions are divided into
  427.                            different sections for IBM PC, Sun-4 (Sparc),
  428.                            and Sun-3.  Please refer to the section which
  429.                            corresponds to your hardware.
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-1
  459.  
  460.  
  461.  
  462.           IBM PC
  463.           -----------------------------------------------------------------          -----------------------------------------------------------------
  464.  
  465.  
  466.           Required         At a minimum you must have the following
  467.           equipment        hardware and software to run Image Alchemy.
  468.  
  469.  
  470.  
  471.                  Computer  An MS-DOS computer equipped with an 80286,
  472.                            80386, or 80486.
  473.  
  474.                            Many of the conversions that Alchemy does are
  475.                            cpu intensive, so a faster computer is
  476.                            definitely an advantage.
  477.  
  478.  
  479.  
  480.                    Memory  At least 380k of free memory.
  481.  
  482.                            Image Alchemy will run much faster if you have
  483.                            more than 420k of memory available.  Some
  484.                            conversions and some images require even more
  485.                            memory (Alchemy will attempt to use all
  486.                            available system memory, so if you get out of
  487.                            memory errors or warnings try removing as many
  488.                            resident programs as you can (also, installing
  489.                            MS-DOS 5.0 will free up more memory)).
  490.  
  491.                            Alchemy does not currently make use of expanded
  492.                            or extended memory.
  493.  
  494.  
  495.  
  496.                Hard drive  A hard drive with at least as much free space as
  497.                            four times the size of the image being converted
  498.                            (i.e. a 640x480 image will require approximately
  499.                            1.2 megabytes of free space).
  500.  
  501.  
  502.  
  503.                   Display  A supported SVGA or 8514/A board, if you wish to
  504.                            view images.
  505.  
  506.                            Supported SVGA boards include those with the
  507.                            Paradise, Everex, Trident, Video 7, and the
  508.                            Tseng Labs chipsets.  Supported 8514/A boards
  509.                            include IBM and those with the Western Digital
  510.                            chipset.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-2
  517.  
  518.  
  519.  
  520.                 Operating  MS-DOS or PC-DOS 3.x or greater (because of the
  521.                    system  additional free memory available use of MS-DOS
  522.                            5.0 is highly recommended).
  523.  
  524.  
  525.  
  526.           Optional         The following hardware and software is optional
  527.           equipment        to run Image Alchemy.
  528.  
  529.  
  530.  
  531.            VESA VGA board  To get full use out of viewing images on a SVGA
  532.                            board a VESA driver is needed.  Without a VESA
  533.                            driver Alchemy is limited to displaying images
  534.                            in 320x200x256, 360x480x256, and 640x400x256
  535.                            mode;  with a VESA driver the resolution is
  536.                            limited only by your SVGA board and monitor.
  537.                            Resolutions up to 1280x1024x256 are possible.
  538.  
  539.                            The VESA driver is supplied by the manufacturer
  540.                            of your SVGA board.  It may already be included
  541.                            in the BIOS on your SVGA board, or it may have
  542.                            been shipped on a floppy disk with your SVGA
  543.                            board.  Consult the documentation that came with
  544.                            the SVGA board.  If there is no mention of a
  545.                            VESA driver in the documentation contact your
  546.                            dealer or the manufacturer of your SVGA board;
  547.                            VESA drivers are currently available for VGA
  548.                            boards using chipsets from Cirrus Logic, ATI
  549.                            Technologies, Chips and Technologies, Everex
  550.                            Systems, Genoa Systems, Paradise Logic, Sigma
  551.                            Designs, STB Systems, Tecmar, Headland
  552.                            Technology (Video 7), Orchid Technology, Appian
  553.                            Technology, Trident Microsystems, and Oak
  554.                            Technology.
  555.  
  556.                            Refer to your SVGA documentation on how to
  557.                            install the VESA driver.
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-3
  575.  
  576.  
  577.  
  578.                Disk cache  You can greatly increase the speed of many of
  579.                            Image Alchemy's conversions by installing a disk
  580.                            cache that postpones writes.  This is because
  581.                            Alchemy uses the hard drive to temporarily store
  582.                            data during many conversions.  A write
  583.                            postponing cache will use extended and/or
  584.                            expanded memory to make this more efficient.
  585.  
  586.                            An example of a write postponing cache, and the
  587.                            one we use at Handmade Software, is the Norton
  588.                            Utilities 6.01 supplied ncache.exe (the cache
  589.                            supplied with MS-DOS 5.0, smartdrv.sys, is NOT a
  590.                            write postponing cache, and while it will help
  591.                            somewhat, it is not nearly as effective).
  592.  
  593.                            Refer to the documentation that came with your
  594.                            cache on how to install it.
  595.  
  596.  
  597.  
  598.                      Math  A math coprocessor will not affect the speed of
  599.               coprocessor  most operations; the only operations that use
  600.                            much floating point math are scaling types c and
  601.                            d.
  602.  
  603.  
  604.  
  605.           Packing list     The enclosed diskette contains the following
  606.                            files:
  607.  
  608.                            ALCHEMY.EXE  The Alchemy program.
  609.  
  610.                            READ.ME      A text document describing any last
  611.                                         minute revisions.
  612.  
  613.                            SAMPLES      A directory containing sample data
  614.                                         files and images.  See the READ.ME
  615.                                         file in this directory for further
  616.                                         information.
  617.  
  618.           Installation     Using the MS-DOS copy command copy the program
  619.           instructions     ALCHEMY.EXE to a directory in your path.  There
  620.                            are no support or configuration files which need
  621.                            to be copied.  (For more information on the copy
  622.                            command or the path command see the DOS user's
  623.                            manual which came with MS-DOS).
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-4
  633.  
  634.  
  635.  
  636.           Note to advanced Alchemy uses the environment variable TMP to
  637.           users            determine where to open its temporary files.  If
  638.                            you have a big enough ram drive you will want to
  639.                            specify it using the TMP variable.  Be aware
  640.                            that Alchemy needs up to 4 times as much space
  641.                            on that drive as the size of the image (a 640 by
  642.                            480 image requires up to 1.2 Megabytes).  An
  643.                            example of setting the TMP variable to drive e:
  644.                            would be "set TMP=e:".
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-5
  691.  
  692.  
  693.  
  694.           Sun-4
  695.           -----------------------------------------------------------------          -----------------------------------------------------------------
  696.  
  697.  
  698.           Required         At a minimum you must have the following
  699.           equipment        hardware and software to run Image Alchemy.
  700.  
  701.  
  702.  
  703.                  Computer  A SPARC equipped Sun (either a Sun-4,
  704.                            SPARCstation, or SPARCserver).
  705.  
  706.  
  707.  
  708.                Disk space  Alchemy uses disk space while converting images.
  709.                            You should have at least 4 times as much disk
  710.                            space available as the image you are converting
  711.                            (i.e.  a 640x480 image will require
  712.                            approximately 1.2 megabytes of disk space).
  713.  
  714.  
  715.  
  716.                 Operating  SunOS 4.0.3 or greater.
  717.                    system
  718.  
  719.  
  720.           Packing list     The enclosed diskette or tape is in tar format
  721.                            and contains the following files:
  722.  
  723.                            alchemy      The Alchemy program.
  724.  
  725.                            read.me      A text document describing any last
  726.                                         minute revisions.
  727.  
  728.                            samples      A directory containing sample data
  729.                                         files and images.  See the read.me
  730.                                         file in this directory for further
  731.                                         information.
  732.  
  733.  
  734.  
  735.           Installation     Use the Sun supplied program tar to copy the
  736.           instructions     files from the distribution disk or tape to the
  737.                            current directory.
  738.  
  739.                            To install the software from diskette use:
  740.  
  741.                                 tar xvf /dev/fd0
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-6
  749.  
  750.  
  751.  
  752.                            For tape installation replace /dev/fd0 with the
  753.                            name of the tape device.  The name of the tape
  754.                            device varies between different models and
  755.                            configurations of Sun systems; ask your system
  756.                            administrator if you don't know the name of your
  757.                            tape device.
  758.  
  759.           Note to advanced Alchemy uses the environment variable TMPDIR to
  760.           users            determine where to put its temporary files.
  761.                            This is usually set to /usr/tmp or /tmp, but if
  762.                            you are converting very large images there may
  763.                            not be enough space available in the partition
  764.                            those directories are on.  In that case you may
  765.                            want to set the environment variable TMPDIR to a
  766.                            different partition.  For example, to set the
  767.                            temporary file directory to the directory
  768.                            /home/images use "setenv TMPDIR /home/images".
  769.                            Contact your system administrator if you have
  770.                            problems with Alchemy running out of disk space
  771.                            while converting images.
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-7
  807.  
  808.  
  809.  
  810.           Sun-3
  811.           -----------------------------------------------------------------          -----------------------------------------------------------------
  812.  
  813.  
  814.           Required         At a minimum you must have the following
  815.           equipment        hardware and software to run Image Alchemy.
  816.  
  817.  
  818.  
  819.                  Computer  A 68020 or 68030 equipped Sun (generally called
  820.                            a Sun-3).
  821.  
  822.  
  823.  
  824.                Disk space  Alchemy uses disk space while converting images.
  825.                            You should have at least 4 times as much disk
  826.                            space available as the image you are converting
  827.                            (i.e.  a 640x480 image will require
  828.                            approximately 1.2 megabytes of disk space).
  829.  
  830.  
  831.  
  832.                 Operating  SunOS 4.0.3 or greater.
  833.                    system
  834.  
  835.  
  836.           Packing list     The enclosed diskette or tape is in tar format
  837.                            and contains the following files:
  838.  
  839.                            alchemy      The Alchemy program.
  840.  
  841.                            read.me      A text document describing any last
  842.                                         minute revisions.
  843.  
  844.                            samples      A directory containing sample data
  845.                                         files and images.  See the read.me
  846.                                         file in this directory for further
  847.                                         information.
  848.  
  849.  
  850.  
  851.           Installation     Use the Sun supplied program tar to copy the
  852.           instructions     files from the distribution disk or tape to the
  853.                            current directory.
  854.  
  855.                            To install the software from diskette use:
  856.  
  857.                                 tar xvf /dev/fd0
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-8
  865.  
  866.  
  867.  
  868.                            For tape installation replace /dev/fd0 with the
  869.                            name of the tape device.  The name of the tape
  870.                            device varies between different models and
  871.                            configurations of Sun systems; ask your system
  872.                            administrator if you don't know the name of your
  873.                            tape device.
  874.  
  875.           Note to advanced Alchemy uses the environment variable TMPDIR to
  876.           users            determine where to put its temporary files.
  877.                            This is usually set to /usr/tmp or /tmp, but if
  878.                            you are converting very large images there may
  879.                            not be enough space available in the partition
  880.                            those directories are on.  In that case you may
  881.                            want to set the environment variable TMPDIR to a
  882.                            different partition.  For example, to set the
  883.                            temporary file directory to the directory
  884.                            /home/images use "setenv TMPDIR /home/images".
  885.                            Contact your system administrator if you have
  886.                            problems with Alchemy running out of disk space
  887.                            while converting images.
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     1-9
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                                                           2
  929.  
  930.  
  931.  
  932.           Introduction
  933.           -----------------------------------------------------------------          -----------------------------------------------------------------
  934.  
  935.  
  936.           Basic            Image Alchemy is a command line driven program.
  937.           instructions     This is different from a menu driven or mouse
  938.                            driven program in that you instruct Alchemy what
  939.                            to do only when you execute it from the command
  940.                            line.  Once the program is running there are no
  941.                            further choices or user interaction.
  942.  
  943.                            The basic Image Alchemy usage instructions are:
  944.  
  945.                            alchemy -option [-option ...] inputFileName
  946.                            [outputFileName] [outputPathName]
  947.  
  948.                            This simply means that you type the name of the
  949.                            program, Alchemy, followed by at least one
  950.                            option, followed by the input file name.  You
  951.                            may optionally specify an output file name or an
  952.                            output path name.
  953.  
  954.                   Options  Options are the commands that you give Alchemy
  955.                            so that it knows what you want it to do.  So
  956.                            that Alchemy can distinguish between options and
  957.                            file names, options are preceded by a dash ("-
  958.                            ").
  959.  
  960.                            The only option that is required is the output
  961.                            file format (or the viewing option, for MS-DOS
  962.                            users).  Image Alchemy will make reasonable
  963.                            decisions for all of the other options.
  964.  
  965.                            Some options take parameters.  The parameters
  966.                            may immediately follow the option or be
  967.                            separated by a space.  For example, either -c128
  968.                            or -c 128 is acceptable.
  969.  
  970.                            The options are documented in Chapters 3 through
  971.                            7.
  972.  
  973.                            Note that options can appear anywhere in the
  974.                            command line and generally they can be in any
  975.                            order (certain options take parameters; in those
  976.                            cases the parameters must follow the option).
  977.                            The case of the options is significant.
  978.  
  979.  
  980.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     2-1
  981.  
  982.  
  983.  
  984.             InputFileName  The inputFileName is any valid file name.  This
  985.                            is the name of an existing image file that you
  986.                            are converting from or viewing.  The
  987.                            inputFileName is required.  It may include an
  988.                            optional drive and/or path.
  989.  
  990.            OutputFileName  The outputFileName is the name of the file you
  991.                            are converting the image to.  The outputFileName
  992.                            is optional;  if it is not specified Image
  993.                            Alchemy generates one by substituting an
  994.                            appropriate extension to the input file name.
  995.                            If you specify an outputFileName and it does not
  996.                            include an extension one will be added.  The
  997.                            outputFileName may include an optional drive
  998.                            and/or path.  If you do not supply a path the
  999.                            current directory will be used as the
  1000.                            destination directory.
  1001.  
  1002.            OutputPathName  The outputPathName is the location where you
  1003.                            want to put the output that Alchemy will create.
  1004.                            The outputPathName is optional;  if it is not
  1005.                            specified Alchemy places the output in the
  1006.                            current directory or in the directory specified
  1007.                            as part of the outputFileName.
  1008.  
  1009.  
  1010.  
  1011.           Limitations on   Since Alchemy lets you optionally enter a space
  1012.           filenames        between an option and its parameter it is
  1013.                            possible to confuse Alchemy if one of the
  1014.                            filenames starts with a number.  In particular,
  1015.                            if you use an option which has an optional
  1016.                            parameter, you do not use a parameter, and you
  1017.                            follow that option immediately with a filename
  1018.                            which starts with a number, Alchemy doesn't
  1019.                            realize that the filename is not the parameter.
  1020.                            While it sounds unlikely that this would ever be
  1021.                            a problem it actually happens quite often.
  1022.  
  1023.                            For example, if you wanted to convert the file
  1024.                            12.gif to a Targa file with the name output.tga
  1025.                            you would have to be careful of the order you
  1026.                            specified things.
  1027.  
  1028.                            If you say
  1029.  
  1030.                                 alchemy -a 12.gif output.tga
  1031.  
  1032.                            Alchemy would misinterpret that as
  1033.  
  1034.                                 alchemy -a12 .gif output.tga
  1035.  
  1036.  
  1037.  
  1038.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     2-2
  1039.  
  1040.  
  1041.  
  1042.                            and would generate an error.
  1043.  
  1044.                            The easiest way around this problem is to always
  1045.                            put the filenames first
  1046.  
  1047.                                 alchemy 12.gif output.tga -a
  1048.  
  1049.                            or don't use filenames which begin with a
  1050.                            number.
  1051.  
  1052.           Output path      The output path name is the location where
  1053.                            Alchemy will place its output.
  1054.  
  1055.                            The outputPathName can be specified as part of
  1056.                            the outputFileName if you are specifying an
  1057.                            outputFileName.
  1058.  
  1059.                            For example
  1060.  
  1061.                                 alchemy sample.jpg -g test.gif \images
  1062.  
  1063.                            is the same as
  1064.  
  1065.                                 alchemy sample.jpg -g \images\test.gif
  1066.  
  1067.                            However,
  1068.  
  1069.                                 alchemy sample.jpg -g
  1070.  
  1071.                            is not the same as
  1072.  
  1073.                                 alchemy sample.jpg -g \images
  1074.  
  1075.                            When using the wildcard option, Alchemy allows
  1076.                            wildcards and multiple file names.  In this case
  1077.                            the use of an outputFileName is not allowed, but
  1078.                            the use of the outputPathName is.  See the
  1079.                            wildcard option below for more information.
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     2-3
  1097.  
  1098.  
  1099.  
  1100.           Using multiple   Sometimes you may know what you want to
  1101.           runs of Alchemy  accomplish but not how to specify the correct
  1102.                            combination of options.  For example, you may
  1103.                            wish to re-size a true colour Targa file that
  1104.                            you have scanned and convert it to a 16 colour
  1105.                            GIF file.  Let's say that the input file name is
  1106.                            file.tga and you want to generate a file with
  1107.                            the name file.gif. In this case you could type:
  1108.  
  1109.                                 alchemy file.tga -Xb640 -Yb480 -c16 -g
  1110.  
  1111.                            However, there would be no penalty in quality
  1112.                            (and little in speed) if you did things in two
  1113.                            steps:
  1114.  
  1115.                                 alchemy file.tga -Xb640 -Yb480 -r temp.raw
  1116.  
  1117.                                 alchemy temp.raw -c16 -g file.gif
  1118.  
  1119.                            In this case you are telling Alchemy to use a
  1120.                            temporary raw file called temp.raw.  It turns
  1121.                            out that Alchemy would have done that
  1122.                            automatically in the first case.  Of course you
  1123.                            will have to manually delete the file temp.raw
  1124.                            when the conversion is finished.
  1125.  
  1126.                            The order of steps is important in many cases.
  1127.                            For example, reversing the order of the two
  1128.                            operations in the previous example:
  1129.  
  1130.                                 alchemy file.tga -c16 -g temp.raw
  1131.  
  1132.                                 alchemy temp.raw -Xb640 -Yb480 -g file
  1133.  
  1134.                            would give different results.  This is because
  1135.                            the scaling operation has to temporarily convert
  1136.                            the image to true colour, but the GIF file you
  1137.                            are generating has to be paletted, so the second
  1138.                            operation would re-dither the image.
  1139.  
  1140.                            Sometimes you will have to perform operations
  1141.                            using multiple steps because there are some
  1142.                            combinations of options that Alchemy explicitly
  1143.                            does not allow.  These combinations of options
  1144.                            are not allowed because the results would not be
  1145.                            what you expect.
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     2-4
  1155.  
  1156.  
  1157.  
  1158.                            For example, using the spiff option, -S, in
  1159.                            combination with the false colour option, -F,
  1160.                            would spiff the image first and then false
  1161.                            colour it, which would give the same results as
  1162.                            just using the false colour option.  Since that
  1163.                            isn't something that you would ever want to do,
  1164.                            Alchemy will complain if you specify both of
  1165.                            those options at the same time.
  1166.  
  1167.                            In this case you could false colour the image
  1168.                            first, generating a temporary image, and then
  1169.                            spiff that image.
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     2-5
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.                                                                           3
  1219.  
  1220.  
  1221.  
  1222.           Output Options
  1223.           -----------------------------------------------------------------          -----------------------------------------------------------------
  1224.  
  1225.  
  1226.           Introduction     The one option which is always required when
  1227.                            running Image Alchemy is the output image file
  1228.                            type.  Even if you are just re-sizing an image,
  1229.                            or changing the number of colours in an image,
  1230.                            Alchemy needs to know what type of image you are
  1231.                            creating.
  1232.  
  1233.                            The file types that Image Alchemy supports are
  1234.                            listed below.  In addition to the syntax
  1235.                            required to generate the file, any known
  1236.                            restrictions or limitations are listed.  If you
  1237.                            have trouble reading an image in one of the file
  1238.                            formats we claim to support please contact us
  1239.                            (see Appendix D, Customer Support).
  1240.  
  1241.                            The common output options consist of a single
  1242.                            letter.  The option, like all Alchemy options,
  1243.                            is preceded by a dash, "-".  The less common
  1244.                            output options consist of a letter preceded by
  1245.                            two dashes, "--".
  1246.  
  1247.                Variations  Some of the output formats have several
  1248.                            variations; in those cases you specify which
  1249.                            variation you want with an optional letter
  1250.                            and/or number after the output option.
  1251.  
  1252.                   Example  The option to generate a Windows Bitmap file is
  1253.                            -w.  There are two types of Bitmap files:
  1254.                            uncompressed and Run-Length-Encoded (RLE).  To
  1255.                            write out an uncompressed Bitmap file use -w0;
  1256.                            to write out a RLE Bitmap file use -w1 (the
  1257.                            default Bitmap file is uncompressed, so a -w
  1258.                            without any parameter following it would also
  1259.                            generate an uncompressed Bitmap file).  Note
  1260.                            that Alchemy allows spaces between the option
  1261.                            and parameter, so typing -w 1 would be the same
  1262.                            as -w1.
  1263.  
  1264.                Variations  Be aware that the other options specified on the
  1265.                            command line also affect the type of file that
  1266.                            is generated.
  1267.  
  1268.  
  1269.  
  1270.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-1
  1271.  
  1272.  
  1273.  
  1274.                   Example  Within the Windows Bitmap file type there are 1
  1275.                            bit, 4 bit, 8 bit, and 24 bit files.
  1276.  
  1277.                            Alchemy always generates a file using the best
  1278.                            match of the file type and the output image.
  1279.                            So, in the case of Windows Bitmap files, if the
  1280.                            output image is black and white a 1 bit file is
  1281.                            generated.  If the output image is paletted with
  1282.                            16 colours or less a 4 bit file is generated.
  1283.                            If the output image is paletted with more than
  1284.                            16 colours an 8 bit file is generated.  And if
  1285.                            the output image is true colour a 24 bit file is
  1286.                            generated.
  1287.  
  1288.                            You can explicitly force any of these file types
  1289.                            by using other Alchemy options.  For example, if
  1290.                            you wanted a 1 bit Windows Bitmap file you would
  1291.                            specify -c2 -b -w.  To force a 4 bit file use
  1292.                            -c16 -w.  To force an 8 bit file use -c256 -w.
  1293.                            And to force a true colour file use -24 -w.
  1294.  
  1295.  
  1296.           Identifying      Image Alchemy identifies the type of file being
  1297.           image files      read by checking various magic numbers and other
  1298.                            information that varies from format to format.
  1299.                            Unfortunately some formats do not have a magic
  1300.                            number; in those cases Alchemy guesses as to the
  1301.                            image type.  It is possible for Image Alchemy to
  1302.                            incorrectly identify an image; if this happens
  1303.                            please contact us.
  1304.  
  1305.           MacBinary        When reading images Alchemy automatically
  1306.                            recognizes and reads MacBinary files (MacBinary
  1307.                            files are generated when you accidently leave
  1308.                            MacBinary mode on when transferring a file from
  1309.                            a Macintosh).
  1310.  
  1311.           Other            Alchemy will preserve as much information in
  1312.           information      each file as is reasonable; this always includes
  1313.                            the height and width of the image and the number
  1314.                            of colours in the image.  Some file types
  1315.                            include other data, such as the name of the
  1316.                            image, the aspect ratio of the image, the date
  1317.                            the image was created, etc.  Since most of these
  1318.                            items are only supported by a few file formats,
  1319.                            Alchemy discards everything but the height,
  1320.                            width, number of colours, gamma, aspect ratio,
  1321.                            and resolution values.
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-2
  1329.  
  1330.  
  1331.  
  1332.           Output Options   The individual output options supported by
  1333.                            Alchemy are described in alphabetical order on
  1334.                            the following pages.  The descriptions follow
  1335.                            the template given overleaf.
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-3
  1387.  
  1388.  
  1389.  
  1390.           Name of format                                            -option
  1391.  
  1392.  
  1393.                            Overview of file format.
  1394.  
  1395.           Syntax           Description of syntax.
  1396.  
  1397.           Parameter        Description of the parameters.
  1398.  
  1399.           Extensions       The extensions commonly used for this image
  1400.                            format.  When multiple extensions are listed
  1401.                            Alchemy writes files using the first one, but
  1402.                            will check for files using all extensions (in
  1403.                            the order listed).  Four letter extensions are
  1404.                            skipped on MS-DOS systems.
  1405.  
  1406.           Creator          The company or individual who created this image
  1407.                            format.  Please contact them for more
  1408.                            information on the format.
  1409.  
  1410.           Used by          Programs or types of software that use this
  1411.                            image format.
  1412.  
  1413.           Variations       A list of the supported variations.
  1414.  
  1415.           Limitations      Any known limitations that Alchemy has when
  1416.                            reading or writing this image format.
  1417.  
  1418.           Comments         Miscellaneous things you should be aware of.
  1419.  
  1420.           Related options  Other Alchemy options that affect the reading or
  1421.                            writing of this image format.  Note that -8, -24
  1422.                            (and, for some formats, -15, -16, and -32), -c,
  1423.                            and -b options have an effect for most image
  1424.                            formats and are not listed explicitly.
  1425.  
  1426.           Example          Example conversions involving this image format.
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-4
  1445.  
  1446.  
  1447.  
  1448.           ADEX                                                          --A
  1449.  
  1450.  
  1451.                            ADEX files are used by the ADEX Corporation
  1452.                            ChromaGraph series of graphics cards.
  1453.  
  1454.           Syntax           --A compressionType
  1455.  
  1456.           Parameter        compressionType:
  1457.                                 0:None
  1458.                                 1:Run Length Coded
  1459.                            The default is None.
  1460.  
  1461.           Extensions       .img
  1462.                            .rle
  1463.  
  1464.           Creator          ADEX Corporation
  1465.  
  1466.           Used by          ADEX ChromaGraph cards.
  1467.  
  1468.           Variations       4 bit and 8 bit images.
  1469.  
  1470.           Comments         Some ADEX files don't contain a palette; in
  1471.                            those cases there's usually a second ADEX file
  1472.                            which contains the palette to be used.  To read
  1473.                            those images that don't have palettes, use the -
  1474.                            F false colour option to read the palette from a
  1475.                            separate file.
  1476.  
  1477.           Related options  -F   False colour
  1478.  
  1479.           Example          Convert the file test.gif to an uncompressed
  1480.                            ADEX file called test.img:
  1481.  
  1482.                                 alchemy --A test.gif
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-5
  1503.  
  1504.  
  1505.  
  1506.           Autologic                                                     --a
  1507.  
  1508.  
  1509.                            Autologic files are black and white or gray-
  1510.                            scale files for use with Autologic typesetting
  1511.                            equipment.
  1512.  
  1513.           Syntax           --a
  1514.  
  1515.           Extensions       .gm
  1516.                            .gm2
  1517.                            .gm4
  1518.  
  1519.           Creator          Autologic, Incorporated
  1520.  
  1521.           Used by          Autologic typesetting equipment.
  1522.  
  1523.           Variations       Graphics modes 2 (black/white) and 4 (gray-
  1524.                            scale) are supported.
  1525.  
  1526.           Limitations      Only the High Speed Interface inline format is
  1527.                            supported.
  1528.  
  1529.                            When reading, images must be preceded by a
  1530.                            Graphics Parameter Block.
  1531.  
  1532.           Examples         Convert the file input.tif to a GM4 file called
  1533.                            output.gm4:
  1534.  
  1535.                                 alchemy --a -b input.tif output.gm4
  1536.  
  1537.                            Convert the file input.tif to a GM2 file called
  1538.                            output.gm2:
  1539.  
  1540.                                 alchemy --a -b -c2 input.tif output.gm2
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-6
  1561.  
  1562.  
  1563.  
  1564.           Binary Information Files (BIF)                                 -B
  1565.  
  1566.  
  1567.                            There are quite a few programs which produce
  1568.                            image files which contain just pixel data.
  1569.                            These image files do not have a header and hence
  1570.                            do not include enough information to allow
  1571.                            Alchemy to read them.
  1572.  
  1573.                            BIF files are a method which can be used to
  1574.                            allow Alchemy to read these images.  BIF files
  1575.                            can also be created to allow images to be read
  1576.                            by software which expects images to be just
  1577.                            pixels.  Since required information, such as the
  1578.                            height and width of the image, are not present
  1579.                            in these files you must supply it.
  1580.  
  1581.           Syntax           -B
  1582.  
  1583.           Extensions       .bif For ASCII file describing image.
  1584.                            .raw For actual image data.
  1585.  
  1586.           Creator          Handmade Software, Inc.
  1587.  
  1588.           Used by          Image Alchemy
  1589.                            Various image processing software
  1590.  
  1591.           Variations       24 bit true colour, 8 bit gray-scale, and 1 bit
  1592.                            black and white.
  1593.  
  1594.           Limitations      Paletted files can not be read in (a work around
  1595.                            is to generate a .PAL file and then false colour
  1596.                            the gray-scale image using the -F option).
  1597.  
  1598.           Comments         BIF files are used to read and write files which
  1599.                            consist entirely of image data.  You have to
  1600.                            generate a text file which describes the format
  1601.                            of the data you are trying to read in.  This
  1602.                            file is called a BIF file.  The format of BIF
  1603.                            files is documented in Appendix E, Binary
  1604.                            Information Files.  You then instruct Alchemy to
  1605.                            read the image data by giving it the name of the
  1606.                            .BIF file.
  1607.  
  1608.           Related options  -F   False colour
  1609.  
  1610.           Examples         Convert the file data to a GIF file:
  1611.  
  1612.                                 alchemy data.bif -g
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-7
  1619.  
  1620.  
  1621.  
  1622.           Encapsulated PostScript (EPS)                                  -e
  1623.  
  1624.  
  1625.                            EPS files are a subset of PostScript; they may
  1626.                            be included by other PostScript files without
  1627.                            requiring that the importing software be able to
  1628.                            interpret the file.
  1629.  
  1630.           Syntax           -e previewType
  1631.  
  1632.           Parameter        previewType:
  1633.                                 0:None
  1634.                                 1:Device independent
  1635.                                 2:TIFF
  1636.                            The default is device independent.
  1637.  
  1638.           Extensions       .epsi
  1639.                            .epi
  1640.  
  1641.           Creator          Adobe Systems, Inc.
  1642.  
  1643.           Used by          PostScript printers
  1644.  
  1645.           Variations       Gray-scale, RGB, and indexed images.
  1646.  
  1647.           Limitations      Alchemy can only write, not read, EPS images.
  1648.  
  1649.           Comments         If the output is gray-scale, it will work with
  1650.                            any PostScript device.  If it's true colour,
  1651.                            then the CMYK extensions or a level 2 device is
  1652.                            required.  For paletted files, a level 2 device
  1653.                            is always required.
  1654.  
  1655.           Examples         Convert the file input.gif to a colour EPS file
  1656.                            called input.eps which will not require level 2
  1657.                            PostScript (but will require CMYK extensions),
  1658.                            with no preview:
  1659.  
  1660.                                 alchemy -e0 -24 input.gif
  1661.  
  1662.  
  1663.  
  1664.                            Convert the file input.gif to a gray-scale EPS
  1665.                            file called gray.eps, with a device independent
  1666.                            preview:
  1667.  
  1668.                                 alchemy -e -b input.gif gray.eps
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-8
  1677.  
  1678.  
  1679.  
  1680.           Erdas LAN/GIS                                                 --e
  1681.  
  1682.  
  1683.                            Erdas files are used by Erdas image processing
  1684.                            software.
  1685.  
  1686.           Syntax           --e
  1687.  
  1688.           Extensions       .lan
  1689.                            .gis
  1690.  
  1691.           Creator          Erdas Inc.
  1692.  
  1693.           Used by          Erdas remote sensing software.
  1694.  
  1695.           Variations       Reads and writes 1 and 3 band files.
  1696.  
  1697.                            Reads 4, 8, and 16 bit files.  Writes 8 bit
  1698.                            files.
  1699.  
  1700.           Limitations      When writing Erdas files Alchemy does not change
  1701.                            the extension depending on the number of bands
  1702.                            in the image; according to the specification
  1703.                            gray-scale files should have the extension .gis
  1704.                            and true colour files should have the extension
  1705.                            .lan.  Alchemy always uses .lan.
  1706.  
  1707.           Comments         1 band files are read in as gray-scale images.
  1708.  
  1709.                            3 band files are read in as true colour images.
  1710.                            The colour mapping between RGB and bands 1, 2,
  1711.                            and 3 is Red=Band 1, Green=Band 2, and Blue=Band
  1712.                            3.
  1713.  
  1714.           Examples         Convert the GIS file texas.gis to a Sun raster
  1715.                            file:
  1716.  
  1717.                                 alchemy texas.gis -s
  1718.  
  1719.                            Convert the file satellite.image to a GIS file.
  1720.  
  1721.                                 alchemy -b --e satellite.image
  1722.                                 satellite.gis
  1723.  
  1724.                            Convert the file satellite.image to a LAN file.
  1725.  
  1726.                                 alchemy --e satellite.image satellite.lan
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     3-9
  1735.  
  1736.  
  1737.  
  1738.           Freedom of the Press                                          --f
  1739.  
  1740.  
  1741.                            Freedom of the Press is a PostScript interpreter
  1742.                            from Custom Applications that converts
  1743.                            PostScript files to raster files.  The Freedom
  1744.                            of the Press format is one of the file types it
  1745.                            can create.
  1746.  
  1747.           Syntax           --f
  1748.  
  1749.           Extension        .fop
  1750.  
  1751.           Creator          Custom Applications
  1752.  
  1753.           Limitations      Output only.
  1754.  
  1755.                            Only CMYK 1 bit per component per pixel
  1756.                            supported.
  1757.  
  1758.           Comments         Freedom of the Press images are actually two
  1759.                            files, a data file and an info file.  You
  1760.                            specify the name of the data file and Alchemy
  1761.                            automatically generates the name of the info
  1762.                            file.  The output file is normally output.001,
  1763.                            output.002, etc.  Alchemy will strip the first
  1764.                            part of the name and replace it with 'info', so
  1765.                            if you specified an output filename of
  1766.                            output.005 there will be another file created
  1767.                            called info.005.  If you don't specify an
  1768.                            extension, Alchemy will use .fop, so you'll get
  1769.                            two files named filename.fop and info.fop.
  1770.                            Alchemy will overwrite info files without
  1771.                            warning.
  1772.  
  1773.           Related options  -C   Undercolour removal
  1774.  
  1775.           Example          Convert the file image.tga to a Freedom of the
  1776.                            Press image called output.003 and info.003,
  1777.                            controlling the undercolour removal process
  1778.                            using sample.ucr, scaling the image to 2500
  1779.                            pixels across (and scaling proportionately
  1780.                            vertically) using nearest neighbor scaling, and
  1781.                            conserving memory:
  1782.  
  1783.                                 alchemy --f -Csample.ucr -X2500 -+ -$
  1784.                                 image.tga output.003
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-10
  1793.  
  1794.  
  1795.  
  1796.           GEM VDI Image File                                            --g
  1797.  
  1798.  
  1799.                            VDI files are black and white files that were
  1800.                            developed by Digital Research to use with GEM.
  1801.  
  1802.           Syntax           --g
  1803.  
  1804.           Extension        .img
  1805.  
  1806.           Creator          Digital Research Inc.
  1807.  
  1808.           Used by          GEM
  1809.  
  1810.           Variations       Reads and writes 1 bit, black and white files.
  1811.  
  1812.           Limitations      The files which are written are not optimally
  1813.                            compressed.
  1814.  
  1815.           Comments         Since GEM VDI files are always 1 bit, black and
  1816.                            white files, Alchemy assumes the use of the -b,
  1817.                            -c2, and -8 options.
  1818.  
  1819.           Examples         Convert the image scan.pcx to a GEM file:
  1820.  
  1821.                                 alchemy scan.pcx --g
  1822.  
  1823.                            Convert the image bigscan.tga to a 640x480 GEM
  1824.                            VDI file, using nearest neighbor scaling and
  1825.                            type 2 dithering:
  1826.  
  1827.                                 alchemy --g bigscan.tga -X640 -Y480 -d2
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-11
  1851.  
  1852.  
  1853.  
  1854.           GIF                                                            -g
  1855.  
  1856.  
  1857.                            GIF files were originally developed by
  1858.                            CompuServe as a machine independent image file
  1859.                            format.  GIF files are clearly the most popular
  1860.                            way of storing 8 bit, scanned or digitized
  1861.                            images.  In addition the compression ratio
  1862.                            achieved by GIF files is usually better than any
  1863.                            other 8 bit format in common use.  GIF89A files
  1864.                            were introduced in 1990 as a method for
  1865.                            including text and simple animations.
  1866.  
  1867.           Syntax           -g version
  1868.  
  1869.           Parameter        version:
  1870.                                 0:  GIF87A
  1871.                                 1:  GIF89A
  1872.                            The default is GIF87A.
  1873.  
  1874.           Extension        .gif
  1875.  
  1876.           Creator          CompuServe, Incorporated
  1877.  
  1878.           Used by          CompuServe
  1879.                            Everyone
  1880.  
  1881.           Variations       Reads 1 through 8 bit GIF87A and GIF89A
  1882.                            interleaved and non-interleaved files.
  1883.  
  1884.                            Writes 1 through 8 bit GIF87A and GIF89A non-
  1885.                            interleaved files.
  1886.  
  1887.           Limitations      When reading GIF89A files only the first image
  1888.                            in the file is read.  Any text, overlays,
  1889.                            pauses, palette changes, etc. are ignored.
  1890.  
  1891.                            Because GIF files only store the size of the
  1892.                            palette to the nearest power of 2 the exact
  1893.                            palette size is lost when converting to and from
  1894.                            GIF files.  For example, if you convert a 240
  1895.                            colour Sun Raster file to a GIF file and back to
  1896.                            a Sun Raster file the resulting Sun Raster file
  1897.                            will have 256 colours.
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-12
  1909.  
  1910.  
  1911.  
  1912.           Comments         When writing a file you probably want to use the
  1913.                            GIF87A variation, since the GIF89A extensions
  1914.                            aren't necessary to store single images and a
  1915.                            lot of other software still can't read GIF89A
  1916.                            images.  The only advantage to GIF89A is that
  1917.                            the aspect ratio of the image is preserved
  1918.                            (GIF87A does not have a provision for storing
  1919.                            aspect ratio).
  1920.  
  1921.                            The GIF format includes a field for storing the
  1922.                            colour to be used for the background when
  1923.                            viewing files.  Alchemy does not make use of
  1924.                            this value.  Alchemy sets the background colour
  1925.                            to the darkest colour in the palette when
  1926.                            viewing files and organizes the palette such
  1927.                            that the first colour is the darkest colour when
  1928.                            writing GIF files, if the palette is created by
  1929.                            Alchemy (you can override this by using the -z
  1930.                            option).
  1931.  
  1932.           Related options  -z   Palette Selection
  1933.  
  1934.           Examples         Convert the image test.pcx to a GIF87A image.
  1935.  
  1936.                                 alchemy test.pcx -g
  1937.  
  1938.                            Convert the file input.tga to a 16 colour GIF89A
  1939.                            file:
  1940.  
  1941.                                 alchemy input.tga -c16 -g1
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-13
  1967.  
  1968.  
  1969.  
  1970.           HP Printer Command Language (PCL)                              -P
  1971.  
  1972.  
  1973.                            HP PCL files are used by HP LaserJets and
  1974.                            compatible printers.
  1975.  
  1976.           Syntax           -P compressionType
  1977.  
  1978.           Parameter        compressionType:
  1979.                                 0:  Uncompressed
  1980.                                 2:  TIFF compressed
  1981.                            The default is uncompressed.
  1982.  
  1983.           Extension        .pcl
  1984.  
  1985.           Creator          Hewlett-Packard Company
  1986.  
  1987.           Used by          HP LaserJet printers
  1988.                            HP compatible laser printers
  1989.  
  1990.           Variations       PCL files are always 1 bit per pixel, black and
  1991.                            white.
  1992.  
  1993.                            Reads and writes uncompressed and TIFF
  1994.                            compressed files.
  1995.  
  1996.           Limitations      In addition to raster images, PCL files can
  1997.                            include text and vector graphics information.
  1998.                            When reading Alchemy only pays attention to
  1999.                            raster images in the file and attempts to skip
  2000.                            everything else.  See Appendix A, Answers to
  2001.                            Frequently Asked Questions, for further
  2002.                            discussion of this.
  2003.  
  2004.                            The only resolutions allowed in PCL files are
  2005.                            75 DPI, 100 DPI, 150 DPI, and 300 DPI; the X and
  2006.                            Y resolution must be the same.  If you specify
  2007.                            any other resolution Alchemy automatically
  2008.                            alters the resolution to the next higher
  2009.                            resolution.  If no resolution is specified the
  2010.                            default is 300 DPI.
  2011.  
  2012.           Comments         Since PCL files are always 1 bit, black and
  2013.                            white files, Alchemy assumes the use of the -b,
  2014.                            -c2, and -8 options.
  2015.  
  2016.                            When converting colour or gray-scale images to
  2017.                            PCL you will probably want to scale the output
  2018.                            so the image will be larger than the input
  2019.                            image.  This will allow the dithering to
  2020.                            preserve more detail in the image.
  2021.  
  2022.  
  2023.  
  2024.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-14
  2025.  
  2026.  
  2027.  
  2028.                            PCL files can be used to generate output which
  2029.                            can be printed on HP LaserJet and compatible
  2030.                            printers.  The easiest method is to simply
  2031.                            generate a .PCL file and then copy it to the
  2032.                            printer by using the copy command (when using
  2033.                            the copy command from MS-DOS you will have to
  2034.                            use a /B to make sure the entire file is copied
  2035.                            to the printer; see the example below for more
  2036.                            information).
  2037.  
  2038.                            All HP laser printers can print uncompressed
  2039.                            files.  The newer models, including the HP
  2040.                            LaserJet III series, can print TIFF compressed
  2041.                            files.  TIFF compressed files are smaller, and
  2042.                            therefore are faster to transmit to the printer.
  2043.  
  2044.           Examples         Convert the image image.gif to a HP PCL file,
  2045.                            using no compression:
  2046.  
  2047.                                 alchemy image.gif -P
  2048.  
  2049.  
  2050.  
  2051.                            Convert the image small.gif to a HP PCL file
  2052.                            called out.pcl with dimensions of 2000 by 2000
  2053.                            at 300 DPI:
  2054.  
  2055.                                 alchemy small.gif -P -X2000 -Y2000 -D 300
  2056.                                 300 out
  2057.  
  2058.                            Print the image generated by the previous
  2059.                            example (for MS-DOS machines only):
  2060.  
  2061.                                 copy /B out.pcl prn:
  2062.  
  2063.                            Convert the image small.gif to a HP PCL file
  2064.                            called out2.pcl with dimensions of 2000 by 2000
  2065.                            at 300 DPI, using TIFF compression:
  2066.  
  2067.                                 alchemy small.gif -P2 -X2000 -Y2000 -D 300
  2068.                                 300 out2
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-15
  2083.  
  2084.  
  2085.  
  2086.           HP Raster Transfer Language (RTL)                             --r
  2087.  
  2088.  
  2089.                            RTL files are used by HP colour raster printers
  2090.                            and plotters.
  2091.  
  2092.           Syntax           --r type
  2093.  
  2094.           Parameter        type:
  2095.                                 0:PaintJet
  2096.                                 1:HP7600 uncompressed
  2097.                                 2:HP7600 PackBits compression
  2098.                                 3:HP7600 planar uncompressed
  2099.                                 4:HP7600 planar PackBits compression
  2100.                                 5:HP7600 planar Group III compression
  2101.                            The default is HP7600 PackBits compression.
  2102.  
  2103.           Extension        .rtl
  2104.  
  2105.           Creator          Hewlett-Packard Company
  2106.  
  2107.           Used by          HP raster plotters and printers including
  2108.                            PaintJets and HP 7600 Series plotters.
  2109.  
  2110.           Variations       CMYK, 1 bit per component per pixel.
  2111.  
  2112.           Limitations      Output only.
  2113.  
  2114.                            The output file is always colour, even if the
  2115.                            image is black & white.
  2116.  
  2117.           Comments         RTL files can be used to produce output which
  2118.                            can be printed on HP colour printers and raster
  2119.                            plotters.  The file can be printed by sending
  2120.                            the file to the plotter.  There is no additional
  2121.                            setup required for the PaintJet.  HP7600 series
  2122.                            plotters should be in HP-GL/2 mode; best results
  2123.                            will generally be achieved with compensation
  2124.                            off.  To get colour plots from the HP7600 series
  2125.                            the plotter must be in 4 or 5 pass mode.  The
  2126.                            file must be sent to the printer/plotter in
  2127.                            binary mode (for MS-DOS systems, use the /B
  2128.                            option with the copy command).
  2129.  
  2130.                            If the input is black and white, you probably
  2131.                            want to do the conversion without an undercolour
  2132.                            removal file and with dithering off.  See below
  2133.                            for an example.
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-16
  2141.  
  2142.  
  2143.  
  2144.                            If the input is gray-scale, you probably do want
  2145.                            to use an undercolour removal file to perform
  2146.                            density correction, but with 100% black removal
  2147.                            (the black removal tables should contain 0
  2148.                            through 255, increasing by one each line) so
  2149.                            that the output won't contain cyan, magenta, or
  2150.                            yellow.  The sample directory on the
  2151.                            distribution diskette has a UCR file called
  2152.                            gray.ucr which has 100% black removal.
  2153.  
  2154.           Related options  -C   Undercolour Removal File
  2155.                            -d   Specify dither type
  2156.  
  2157.           Examples         Convert the black and white image test.wpg to a
  2158.                            RTL file for a PaintJet called test.rtl, not
  2159.                            using a UCR file and with dithering off:
  2160.  
  2161.                                 alchemy --r0 -d0 test.wpg
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-17
  2199.  
  2200.  
  2201.  
  2202.                            Convert the file image.tga to a RTL file for a
  2203.                            PaintJet called image.rtl, using the undercolour
  2204.                            removal file sample.ucr:
  2205.  
  2206.                                 alchemy --r0 -Csample.ucr image.tga
  2207.  
  2208.                            Convert the file image.tga to a planar RTL file
  2209.                            called image.rtl using PackBits compression,
  2210.                            controlling the undercolour removal process
  2211.                            using sample.ucr, scaling the image to 3000
  2212.                            pixels across using good quality scaling,
  2213.                            preserving the aspect ratio (by proportionately
  2214.                            scaling the image vertically), and conserving
  2215.                            memory:
  2216.  
  2217.                                 alchemy --r4 -Csample.ucr -Xb3000 -+ -$
  2218.                                 image.tga
  2219.  
  2220.                            Plot the image generated by the previous example
  2221.                            (for MS-DOS machines with the plotter connected
  2222.                            to a port which is mapped to prn:):
  2223.  
  2224.                                 copy /b image.rtl prn:
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-18
  2257.  
  2258.  
  2259.  
  2260.           HSI JPEG                                                      --j
  2261.  
  2262.  
  2263.                            The HSI JPEG format is a variation of the JPEG
  2264.                            format that was designed by Handmade Software to
  2265.                            better compress paletted images.  Paletted
  2266.                            images often have large areas where the image
  2267.                            consists of 1 or 2 colours; JPEG compression
  2268.                            does a poor job on these sections when compared
  2269.                            to LZW compression.  HSI JPEG files are a
  2270.                            combination of JPEG and LZW compression.
  2271.  
  2272.           Syntax           --j
  2273.  
  2274.           Extension        .jpg
  2275.  
  2276.           Creator          Handmade Software, Inc.
  2277.  
  2278.           Used by          Image Alchemy
  2279.                            GIF2JPG (another Handmade Software product)
  2280.  
  2281.           Variations       8 bit paletted
  2282.  
  2283.           Comments         HSI JPEG files are not compatible with JPEG or
  2284.                            JFIF files.  If you intend to transfer files to
  2285.                            other systems do not use this format, use the
  2286.                            standard JPEG format instead (using the -j
  2287.                            option).
  2288.  
  2289.           Example          Convert the file madonna.gif to a HSI JPEG file:
  2290.  
  2291.                                 alchemy --j madonna.gif
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-19
  2315.  
  2316.  
  2317.  
  2318.           HSI Palette                                                    -l
  2319.  
  2320.  
  2321.                            PAL files are palettes which are ASCII files
  2322.                            that can be edited with a text editor.
  2323.  
  2324.           Syntax           -l (lower case L)
  2325.  
  2326.           Extension        .pal
  2327.  
  2328.           Creator          Handmade Software, Inc.
  2329.  
  2330.           Used by          Image Alchemy
  2331.  
  2332.           Variations       Palette files are always ASCII files.
  2333.  
  2334.           Limitations      .PAL files contain only a palette.
  2335.  
  2336.                            Viewing a .PAL file or converting a .PAL file to
  2337.                            another image format is not allowed.
  2338.  
  2339.           Comments         The format of PAL files is described in
  2340.                            Appendix H.
  2341.  
  2342.           Related options  -f   Match image to specified palette
  2343.                            -F   False colour with specified palette
  2344.  
  2345.           Examples         Extract the palette from the GIF file
  2346.                            madonna.gif:
  2347.  
  2348.                                 alchemy madonna.gif -l
  2349.  
  2350.                            Convert the file image.tga to a GIF file,
  2351.                            matching the palette found in standard.pal:
  2352.  
  2353.                                 alchemy image.tga -g -f standard.pal
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-20
  2373.  
  2374.  
  2375.  
  2376.           HSI Raw                                                        -r
  2377.  
  2378.  
  2379.                            HSI Raw files are used internally by Image
  2380.                            Alchemy when converting between certain
  2381.                            combinations of image formats.  If you are
  2382.                            interested in converting custom format images to
  2383.                            be used with Image Alchemy we suggest using HSI
  2384.                            Raw Files.
  2385.  
  2386.           Syntax           -r
  2387.  
  2388.           Extension        .raw
  2389.  
  2390.           Creator          Handmade Software Inc.
  2391.  
  2392.           Used by          Image Alchemy
  2393.  
  2394.           Variations       8 bit paletted and 24 bit true colour,
  2395.                            uncompressed, not packed.
  2396.  
  2397.           Comments         This format is used internally as temporary
  2398.                            files by Alchemy when doing certain image
  2399.                            conversions; it can also be explicitly read and
  2400.                            written.  This format is described in Appendix
  2401.                            F.
  2402.  
  2403.           Examples         Convert the file test.lbm to a raw file:
  2404.  
  2405.                                 alchemy test.lbm -r
  2406.  
  2407.                            Convert the raw file, test.raw, to a 24 bit
  2408.                            Targa file called output.tga:
  2409.  
  2410.                                 alchemy -24 -a test.raw output.tga
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-21
  2431.  
  2432.  
  2433.  
  2434.           IFF/ILBM                                                       -i
  2435.  
  2436.  
  2437.                            IFF (Interchange File Format) files are used by
  2438.                            Amiga computers for storing a number of types of
  2439.                            data, including images, text, and music; ILBM
  2440.                            (InterLeaved BitMap) is a type of IFF file used
  2441.                            to store images.
  2442.  
  2443.           Syntax           -i
  2444.  
  2445.           Extensions       .lbm
  2446.                            .iff
  2447.                            .ilbm
  2448.  
  2449.           Creator          Commodore-Amiga Corp.
  2450.  
  2451.           Used by          Amiga
  2452.                            Deluxe Paint
  2453.  
  2454.           Variations       Reads 1 through 8 bit, 24 bit, and HAM images
  2455.  
  2456.                            Writes 1 through 8 bit and 24 bit images.
  2457.  
  2458.           Limitations      Dynamic Hi-Res images are not supported.
  2459.  
  2460.                            Does not write images in any of the Amiga
  2461.                            specific display modes.
  2462.  
  2463.           Comments         If you're writing an ILBM file for use on an
  2464.                            Amiga, you probably want to write either a
  2465.                            paletted file with 32 colours or a 24 bit file.
  2466.                            24 bit ILBM files can then be converted to one
  2467.                            of the Amiga specific display modes with various
  2468.                            third-party utilities.
  2469.  
  2470.           Example          Convert the file input.pcx to an IFF/ILBM file
  2471.                            called output.lbm with 32 colours:
  2472.  
  2473.                                 alchemy -i -c32 input.pcx output.lbm
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-22
  2489.  
  2490.  
  2491.  
  2492.           JPEG/JFIF                                                      -j
  2493.  
  2494.  
  2495.                            JPEG is a new type of image file format that
  2496.                            uses a lossy compression technique to achieve
  2497.                            high compression ratios.  See Appendix C, JPEG
  2498.                            Compression, for more information.
  2499.  
  2500.           Syntax           -j[coding] quality
  2501.  
  2502.           Parameters       coding:
  2503.                                 Specify the type of entropy coding to
  2504.                            perform.
  2505.                                    none:  default Huffman coding
  2506.                                    h:  optimum Huffman coding
  2507.                            quality:
  2508.                                 1 through 100 (larger is higher quality)
  2509.                            The default quality is 32.
  2510.  
  2511.           Extension        .jpg
  2512.  
  2513.           Creator          Joint Photographic Experts Group (JPEG)
  2514.  
  2515.           Used by          Lossy compression of photographic images.
  2516.  
  2517.           Variations       Gray-scale images are saved as single channel
  2518.                            JPEG files; colour images are saved as three
  2519.                            channel JPEG files.
  2520.  
  2521.                            Reads and writes baseline JPEG with CCIR-601
  2522.                            YCbCr colour space, interleaved components,
  2523.                            Huffman coded.
  2524.  
  2525.                            Alchemy can read files with any component sub-
  2526.                            sampling up to 4x4; it always writes 2h:1v 1h:1v
  2527.                            1h:1v.
  2528.  
  2529.                            Alchemy JPEG files comply with the industry
  2530.                            standard `JFIF' interchange format.
  2531.  
  2532.           Limitations      Can not read non-interleaved JPEG files.
  2533.  
  2534.                            JPEG files are always lossy, which means that
  2535.                            the compressed image is not identical to the
  2536.                            original image.  At high quality factors (32 and
  2537.                            above) this loss is generally so slight as to be
  2538.                            barely noticeable.  There is no quality factor
  2539.                            which is guaranteed to be lossless.
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-23
  2547.  
  2548.  
  2549.  
  2550.           Comments         By default, Image Alchemy uses a fixed set of
  2551.                            Huffman tables to compress an image.  If the -j
  2552.                            is immediately followed by an 'h', Alchemy will
  2553.                            generate a set of custom tables optimized for
  2554.                            the image and quality factor.  This usually
  2555.                            produces 5-20% better compression (depending on
  2556.                            the image content and quality factor) but
  2557.                            requires an additional pass over the image data,
  2558.                            so it takes a little longer to compress (there's
  2559.                            no effect on the decompression time).
  2560.  
  2561.                            Quality may vary between 1 and 100; the default
  2562.                            is 32.  The higher the number the higher the
  2563.                            quality of the image and the lower the
  2564.                            compression ratio.  Quality factors below 10
  2565.                            will produce images with significant loss of
  2566.                            quality.
  2567.  
  2568.                            JPEG files are based on the Joint Photographic
  2569.                            Experts Group (JPEG) CD 10918-1 draft standard.
  2570.  
  2571.                            Since JPEG compression was designed for use with
  2572.                            continuous tone images (such as those produced
  2573.                            by a scanner or digitizer), poor results can be
  2574.                            expected when compressing line drawings.
  2575.  
  2576.           Related options  -q   Apply Smoothing when decompressing a JPEG
  2577.                            image.
  2578.  
  2579.                            Because JPEG compression works on 8x8 pixel
  2580.                            blocks there may be discontinuities at the edges
  2581.                            of these blocks producing block artifacts.
  2582.                            Smoothing attempts to reduce these artifacts.
  2583.                            Smoothing is really only necessary at very low
  2584.                            quality settings (less than 10); even then the
  2585.                            effects of smoothing are not particularly
  2586.                            significant.
  2587.  
  2588.           Examples         Convert the file photo.tga to a JPEG file called
  2589.                            photo.jpg, using a high quality setting:
  2590.  
  2591.                                 alchemy -j70 photo.tga
  2592.  
  2593.                            Convert the JPEG file, lores.jpg, to a PCX file
  2594.                            using smoothing:
  2595.  
  2596.                                 alchemy lores.jpg -p -q
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-24
  2605.  
  2606.  
  2607.  
  2608.           Jovian VI                                                     --J
  2609.  
  2610.  
  2611.                            Jovian VI files are created by the Jovian Logic
  2612.                            video capture boards.
  2613.  
  2614.           Syntax           --J
  2615.  
  2616.           Extensions       .vi
  2617.  
  2618.           Creator          Jovian Logic Corp.
  2619.  
  2620.           Used by          Jovian Logic
  2621.  
  2622.           Variations       Reads 1, 4, 6, and 8 bit gray-scale images, 4
  2623.                            and 8 bit colour paletted images, and 16 and 24
  2624.                            bit true colour images.
  2625.  
  2626.                            Writes 8 bit gray-scale, 4 and 8 bit colour
  2627.                            paletted images, and 16 and 24 bit true colour
  2628.                            images.
  2629.  
  2630.           Limitations      Reads files with 6 and 8 bit palettes, always
  2631.                            writes 6 bit palettes.
  2632.  
  2633.                            Gray-scale files are always 8 bit.
  2634.  
  2635.           Comments         When writing a VI file the palette always starts
  2636.                            at 0, but will not necessarily be black (which
  2637.                            is the way that Jovian VI files are written).
  2638.  
  2639.           Example          Convert the GIF file, test.gif, to a 16 colour
  2640.                            VI file:
  2641.  
  2642.                                 alchemy test.gif --J -c16
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-25
  2663.  
  2664.  
  2665.  
  2666.           Macintosh PICT/PICT2                                           -m
  2667.  
  2668.  
  2669.                            PICT files were created by Apple Computer as a
  2670.                            common format for Macintosh applications to use.
  2671.                            Virtually every Macintosh application can use
  2672.                            PICT files.
  2673.  
  2674.           Syntax           -m
  2675.  
  2676.           Extensions       .pict
  2677.                            .pic
  2678.  
  2679.           Creator          Apple Computer, Inc.
  2680.  
  2681.           Used by          Macintosh computers
  2682.  
  2683.           Variations       Reads 1, 2, 4, 8, 16, and 32 bit PICT and PICT2
  2684.                            images
  2685.  
  2686.                            Writes 1, 2, 4, 8, and 32 bit PICT2 images.
  2687.  
  2688.           Limitations      Only pays attention to pixMaps in the image;
  2689.                            attempts to skip everything else.
  2690.  
  2691.           Comments         Due to the enormous number of options allowed in
  2692.                            PICT files, reading PICTs may not always work.
  2693.                            See Appendix A, Answers to Frequently Asked
  2694.                            Questions, for more information.
  2695.  
  2696.           Example          Convert the file input1.gif to a Mac PICT file
  2697.                            called input1.pic:
  2698.  
  2699.                                 alchemy -m input1.gif
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-26
  2721.  
  2722.  
  2723.  
  2724.           MTV Ray Tracer                                                --M
  2725.  
  2726.  
  2727.                            MTV files are used by the MTV RayTracer, a
  2728.                            public domain ray tracer for Suns and other
  2729.                            workstations.
  2730.  
  2731.           Syntax           --M
  2732.  
  2733.           Extension        .mtv
  2734.  
  2735.           Creator          Mark T. VandeWettering
  2736.  
  2737.           Used by          MTV Raytracer
  2738.  
  2739.           Variations       24 bit true colour.
  2740.  
  2741.           Comments         MTV is a public domain ray-tracer available free
  2742.                            of charge via anonymous ftp from
  2743.                            drizzle.cs.uoregon.edu or via floppy disk from
  2744.                            us.
  2745.  
  2746.           Example          Convert the file spheres.img to a MTV file:
  2747.  
  2748.                                 alchemy spheres.img --M
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-27
  2779.  
  2780.  
  2781.  
  2782.           PCPAINT/Pictor Page Format                                     -A
  2783.  
  2784.  
  2785.                            The Pictor format was designed so that an image
  2786.                            could be loaded into an IBM graphics adapter
  2787.                            very quickly; it does this by almost exactly
  2788.                            duplicating the organization of the graphics
  2789.                            adapter memory.  This makes the format hardware
  2790.                            dependent.
  2791.  
  2792.           Syntax           -A type
  2793.  
  2794.           Parameter           type:
  2795.                                    0:320x200x4 CGA*
  2796.                                    1:320x200x16 PCjr/Tandy*
  2797.                                    2:640x200x2 CGA*
  2798.                                    3:640x200x16 EGA
  2799.                                    4:640x350x2 EGA
  2800.                                    5:640x350x4 EGA
  2801.                                    6:640x350x16 EGA
  2802.                                    7:720x348x2 Hercules*
  2803.                                    8:640x350x16 VGA
  2804.                                    9:320x200x16 EGA
  2805.                                    10:640x400x2 AT&T/Toshiba*
  2806.                                    11:320x200x256 VGA/MCGA
  2807.                                    12:640x480x16 VGA
  2808.                                    13:720x348x16 Hercules InColor*
  2809.                                    14:640x480x2 VGA/MCGA
  2810.                                    15:800x600x2 EGA/VGA
  2811.                                    16:800x600x16 EGA/VGA
  2812.                                    17:640x400x256 SVGA
  2813.                                    18:640x480x256 SVGA
  2814.                                    19:800x600x256 SVGA
  2815.  
  2816.  
  2817.                                    20:1024x768x2 SVGA
  2818.                                    21:1024x768x16 SVGA
  2819.                                    22:360x480x256 VGA
  2820.                                    23:1024x768x256 SVGA
  2821.                               The default is 640x480x256 SVGA.
  2822.                               *These modes are not yet supported.
  2823.  
  2824.           Extension        .pic
  2825.                            .clp
  2826.  
  2827.           Creator          John Bridges
  2828.  
  2829.           Used by          PCPAINT
  2830.                            GRASP
  2831.  
  2832.           Variations       There are variations for most IBM and third
  2833.                            party graphics adapter display modes.
  2834.  
  2835.  
  2836.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-28
  2837.  
  2838.  
  2839.  
  2840.           Limitations      Only the EGA and VGA modes are supported at this
  2841.                            time.  Text modes are not supported.
  2842.  
  2843.           Comments         Some Pictor files do not contain palettes.  For
  2844.                            those files Alchemy will default to using a
  2845.                            standard palette appropriate to the display mode
  2846.                            the file was saved in.  However, the image may
  2847.                            not use the default palette; in that case you
  2848.                            can read the palette from another file with the
  2849.                            -F false colour option.
  2850.  
  2851.           Related options  -F   False colour
  2852.  
  2853.           Example          Convert the file image.pcx to a Pictor file
  2854.                            called image.pic, for 800x600x256 SVGA mode:
  2855.  
  2856.                                 alchemy -A19 image.pcx
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-29
  2895.  
  2896.  
  2897.  
  2898.           PCX                                                            -p
  2899.  
  2900.  
  2901.                            PCX files are used extensively by MS-DOS
  2902.                            machines.  Originally created by ZSoft for use
  2903.                            by their paint packages, PCX files can be read
  2904.                            and written by almost all MS-DOS paint software
  2905.                            and desktop publishing software.
  2906.  
  2907.                            A new variation of PCX file, DCX, is used by
  2908.                            many MS-DOS fax boards.
  2909.  
  2910.                            PCX files suffer from two problems:  the
  2911.                            compression ratio is poor for 8 and 24 bit
  2912.                            images and PCX files are often written out
  2913.                            incorrectly; see the Limitations section below
  2914.                            for details.
  2915.  
  2916.           Syntax           -p type
  2917.  
  2918.           Parameter        type:
  2919.                                 0:Standard PCX
  2920.                                 1:DCX
  2921.                            The default is standard PCX.
  2922.  
  2923.           Extension        .pcx
  2924.  
  2925.           Creator          ZSoft Corporation
  2926.  
  2927.           Used by          PC Paint
  2928.                            Publisher's Paintbrush
  2929.                            Most paint and desktop publishing software can
  2930.                            read and write PCX files.
  2931.                            Fax board software uses the DCX variation of
  2932.                            PCX.
  2933.  
  2934.           Variations       1, 4, 8, and 24 bits per pixel for standard PCX
  2935.                            files.
  2936.                            1 bit per pixel for DCX files.
  2937.  
  2938.           Limitations      PCX format files are often written out
  2939.                            incorrectly; Alchemy attempts to figure out what
  2940.                            is wrong and make intelligent decisions (things
  2941.                            Alchemy can deal with include PCX files without
  2942.                            palettes, files missing the last line of image
  2943.                            data, and files with illegal (and incorrect)
  2944.                            combinations of bits per pixel and planes).
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-30
  2953.  
  2954.  
  2955.  
  2956.                            24 bit PCX files are very new and most other
  2957.                            software can not read them.  Therefore, unless
  2958.                            you are sure that the software you are using can
  2959.                            read a 24 bit PCX file, you probably want to use
  2960.                            the -8 option to force Alchemy to write a
  2961.                            paletted file when generating a PCX file.
  2962.  
  2963.                            DCX files are multiple page PCX images which are
  2964.                            used by various manufacturers of fax boards and
  2965.                            fax software.  Alchemy only reads the first page
  2966.                            of a DCX file.  Alchemy always writes single
  2967.                            page DCX files which are black and white.
  2968.  
  2969.           Comments         Because so many software packages can read and
  2970.                            write PCX files we are especially interested in
  2971.                            supporting as many variations as possible.  If
  2972.                            you have any PCX files which Alchemy does not
  2973.                            read correctly please contact us.
  2974.  
  2975.                            Since DCX files are always 1 bit, black and
  2976.                            white images, Alchemy assumes the use of
  2977.                            -b -c2 -8 when writing the DCX variation of PCX.
  2978.  
  2979.                            ZSoft recently changed some of the information
  2980.                            in the header of PCX files so they now include
  2981.                            image resolution.  Some fax board software makes
  2982.                            use of this information when transmitting PCX or
  2983.                            DCX files as faxes.  See the example section
  2984.                            below for an example of how to specify image
  2985.                            resolution when writing a PCX file.
  2986.  
  2987.           Related options  -D   Specify image resolution.
  2988.  
  2989.           Example          Convert the GIF file, lush.gif, to a PCX file:
  2990.  
  2991.                                 alchemy lush.gif -p
  2992.  
  2993.                            Convert the scanned image, page1.tif, to a DCX
  2994.                            file:
  2995.  
  2996.                                 alchemy -p1 page1.tif
  2997.  
  2998.                            Convert the scanned image, page2.tif, to a DCX
  2999.                            file, specifying an image resolution of 200x100
  3000.                            (a common resolution for fax images):
  3001.  
  3002.                                 alchemy -p1 page2.tif -D 200 100
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-31
  3011.  
  3012.  
  3013.  
  3014.           Portable BitMap (PBM)                                          -k
  3015.  
  3016.  
  3017.                            The Portable BitMap format was developed by Jef
  3018.                            Poskanzer to allow the transferring of black and
  3019.                            white image files between different
  3020.                            workstations.  The PBM format has grown to
  3021.                            include black and white, gray-scale, and true
  3022.                            colour images, a large set of programs to
  3023.                            convert various other image formats to and from
  3024.                            PBM, and a set of image manipulation tools.  The
  3025.                            PBM tools are available free of charge
  3026.                            (unfortunately, due to their memory
  3027.                            requirements, many are not useable on MS-DOS
  3028.                            machines).
  3029.  
  3030.           Syntax           -k
  3031.  
  3032.           Extensions       .pnm Portable aNyMap (Any of those below)
  3033.                            .pbm Portable BitMap (Black and white)
  3034.                            .pgm Portable GrayMap (Gray-scale)
  3035.                            .ppm Portable PixelMap (True colour)
  3036.  
  3037.           Creator          Jef Poskanzer
  3038.  
  3039.           Used by          Portable BitMap Package
  3040.                            Various workstation graphic programs
  3041.  
  3042.           Variations       Reads and writes 1, 8, and 24 bit RAWBITS
  3043.                            (binary) images.
  3044.  
  3045.                            To write out a PBM file use -b -c2.
  3046.                            To write out a PGM file use -b -c256.
  3047.                            To write out a PPM file use -24.
  3048.  
  3049.           Limitations      When writing a PBM file Alchemy always uses the
  3050.                            .pnm extension (the extension should be changed
  3051.                            based on the type of file being written).
  3052.  
  3053.           Comments         The PBM package is a set of image manipulation
  3054.                            tools which run on various workstations.  The
  3055.                            software is available for free via anonymous ftp
  3056.                            from expo.lcs.mit.edu as contrib/pbmplus.tar.Z,
  3057.                            ftp.ee.lbl.gov as pbmplus.tar.Z, or via floppy
  3058.                            disk from us.
  3059.  
  3060.           Examples         Convert the file sun.im32 to a PBM file:
  3061.  
  3062.                                 alchemy sun.im32 -k -b -c2
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-32
  3069.  
  3070.  
  3071.  
  3072.           Q0                                                            --q
  3073.  
  3074.  
  3075.                            The Q0 format is apparently commonly used by
  3076.                            various Japanese scanning, painting, and viewing
  3077.                            software to store 24 bit images.  Handmade
  3078.                            Software has no information other than a basic
  3079.                            description of the format and some sample
  3080.                            images; if you have further information on the
  3081.                            Q0 format please contact us.
  3082.  
  3083.           Syntax           --q
  3084.  
  3085.           Extensions       .q0  For pixel data
  3086.                            .rgb For pixel data
  3087.                            .fal For image header information
  3088.  
  3089.           Creator          Unknown
  3090.  
  3091.           Used by          Various Japanese image processing software.
  3092.  
  3093.           Variations       24 bits per pixel
  3094.  
  3095.           Comments         Q0 files are actually two files, one with the
  3096.                            extension .rgb or .q0 and the other with the
  3097.                            extension .fal.  The .rgb or .q0 file contains
  3098.                            the actual image data and the .fal file contains
  3099.                            the header information (primarily the height and
  3100.                            width of the image).  You specify the name of
  3101.                            the .rgb or .q0 file and Alchemy automatically
  3102.                            generates the name of the .fal file.
  3103.  
  3104.                            When writing a Q0 file Alchemy will overwrite,
  3105.                            without warning, existing .fal files.
  3106.  
  3107.           Example          Convert the file dogcow.gif to a Q0 file:
  3108.  
  3109.                                 alchemy dogcow.gif --q
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-33
  3127.  
  3128.  
  3129.  
  3130.           QDV                                                           --D
  3131.  
  3132.  
  3133.                            The QDV format is used by Giffer, a Macintosh
  3134.                            program which displays and converts image files.
  3135.  
  3136.           Syntax           --D
  3137.  
  3138.           Extension        .qdv
  3139.  
  3140.           Creator          Steve Blackstock
  3141.  
  3142.           Used by          Giffer
  3143.  
  3144.           Variations       QDV files are always 8 bits per pixel.
  3145.  
  3146.           Comments         Giffer is a great shareware (Beerwaretm,
  3147.                            actually) program for the Macintosh that
  3148.                            converts between various image file formats and
  3149.                            allows viewing of graphics files.
  3150.  
  3151.                            Since QDV files are always paletted, Alchemy
  3152.                            assumes the use of the -8 option when writing
  3153.                            QDV files.
  3154.  
  3155.           Example          Convert the file input.tga to a qdv file:
  3156.  
  3157.                                 alchemy input.tga --D
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-34
  3185.  
  3186.  
  3187.  
  3188.           QRT                                                           --T
  3189.  
  3190.  
  3191.                            QRT files are generated by the QRT Ray Tracer, a
  3192.                            public domain ray-tracer for Amiga, Macintosh,
  3193.                            and IBM PC computers.
  3194.  
  3195.           Syntax           --T
  3196.  
  3197.           Extension        .raw
  3198.  
  3199.           Creator          Steve Korn
  3200.  
  3201.           Used by          QRT Ray Tracer
  3202.  
  3203.           Variations       24 bits per pixel
  3204.  
  3205.           Comments         Since QRT files are always true colour, Alchemy
  3206.                            assumes use of the -24 option.
  3207.  
  3208.           Example          Convert the file spheres.gif to a QRT file
  3209.                            called spheres.raw:
  3210.  
  3211.                                 alchemy --T spheres.gif
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-35
  3243.  
  3244.  
  3245.  
  3246.           Scodl                                                         --s
  3247.  
  3248.  
  3249.                            Scodl files are used by Agfa/Matrix slide
  3250.                            recorders.
  3251.  
  3252.           Syntax           --s
  3253.  
  3254.           Extension        .scd
  3255.  
  3256.           Creator          Agfa Corporation / Matrix Instruments Inc.
  3257.  
  3258.           Used by          Agfa/Matrix slide recorders
  3259.  
  3260.           Variations       Writes 8 and 24 bit run-length coded (RLC)
  3261.                            images.
  3262.  
  3263.           Limitations      Output only.
  3264.  
  3265.           Comments         The image should be scaled up to either
  3266.                            2000x1366 or 4000x2732 to fill the slide.
  3267.  
  3268.                            There are some limitations with the current
  3269.                            version of the MVP software driver supplied by
  3270.                            Agfa/Matrix:
  3271.  
  3272.                            24 bit Scodl files are not correctly interpreted
  3273.                            by the MVP driver version 4.1 and earlier.  8
  3274.                            bit images are correctly interpreted.
  3275.  
  3276.                            When sending very large images to the background
  3277.                            MVP driver you must be using version 4.0 or
  3278.                            later and have lots of EMS memory (4 Megabytes
  3279.                            is recommended).  When using the foreground MVP
  3280.                            program turning on disk caching is necessary.
  3281.  
  3282.           Example          Convert the file picture.im32 to a Scodl file
  3283.                            using high quality scaling and preserving the
  3284.                            aspect ratio:
  3285.  
  3286.                                 alchemy --s -Xc2000 -Yc1366 -+ picture.im32
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-36
  3301.  
  3302.  
  3303.  
  3304.           Silicon Graphics Image                                         -n
  3305.  
  3306.  
  3307.                            Silicon Graphics Image files are used by Silicon
  3308.                            Graphics workstations.
  3309.  
  3310.           Syntax           -n
  3311.  
  3312.           Extension        .sgi
  3313.  
  3314.           Creator          Silicon Graphics, Inc.
  3315.  
  3316.           Used by          Silicon Graphics workstations.
  3317.  
  3318.           Variations       Reads 1, 8 (gray-scale), and 24 bit verbatim
  3319.                            (uncompressed) and RLE files.
  3320.  
  3321.                            Writes 1, 8 (gray-scale), and 24 bit verbatim
  3322.                            files.
  3323.  
  3324.           Limitations      Only uncompressed (verbatim) files can be
  3325.                            written.
  3326.  
  3327.           Comments         Only gray-scale images may be 8 bit files.
  3328.                            Alchemy will automatically switch to 24 bit mode
  3329.                            when writing a colour image.
  3330.  
  3331.           Example          Convert the Sun raster file sun.im8 to a SGI
  3332.                            file called sgiout:
  3333.  
  3334.                                 alchemy -n sun.im8 sgiout -.
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-37
  3359.  
  3360.  
  3361.  
  3362.           Stork                                                          -K
  3363.  
  3364.  
  3365.                            Stork files are CMYK images used by Stork's
  3366.                            colour proofing machines.
  3367.  
  3368.           Syntax           -K compressionType
  3369.  
  3370.           Parameter        compressionType:
  3371.                                 0:None
  3372.                                 1:Run length coded
  3373.                            The default is none.
  3374.  
  3375.           Extensions       .idx Index file
  3376.                            .pre Image data
  3377.                            .tab Colour lookup table
  3378.  
  3379.           Creator          Stork Colorproofing B.V.
  3380.  
  3381.           Used by          Stork Colorproofing machines
  3382.  
  3383.           Variations       Reads and writes 32 KCMY, 32 KCMY RLC, 16 CLU,
  3384.                            and 16 CLU RLC images (type 100, 101, 300, and
  3385.                            301, respectively).
  3386.  
  3387.           Limitations      Alchemy can't write paletted files with more
  3388.                            than 256 colours.
  3389.  
  3390.                            When reading paletted files with more than 256
  3391.                            colours they are treated as true colour.
  3392.  
  3393.           Comments         Stork images are stored in two or three files
  3394.                            (depending on whether or not there's a colour
  3395.                            lookup table associated with the image).  The
  3396.                            filename given to Alchemy should be the name of
  3397.                            the data file (normally with a suffix of .pre);
  3398.                            Alchemy will generate the names of the other
  3399.                            files by stripping the extension and appending
  3400.                            .idx for the index file and .tab for the colour
  3401.                            lookup table (if any).  Alchemy will overwrite
  3402.                            existing .idx and .tab files without warning
  3403.                            when creating Stork files.
  3404.  
  3405.           Related options  -C   Undercolour Removal File
  3406.  
  3407.           Example          Convert the file image.tga to an uncompressed
  3408.                            Stork image called image.pre and image.idx,
  3409.                            using the undercolour removal file sample.ucr:
  3410.  
  3411.                                 alchemy -K -Csample.ucr image.tga
  3412.  
  3413.  
  3414.  
  3415.  
  3416.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-38
  3417.  
  3418.  
  3419.  
  3420.           Sun Raster                                                     -s
  3421.  
  3422.  
  3423.                            Sun Raster files are used by Sun Microsystems
  3424.                            workstations.
  3425.  
  3426.           Syntax           -s
  3427.  
  3428.           Extensions       .rast
  3429.                            .ras
  3430.                            .im
  3431.                            .im1
  3432.                            .im8
  3433.                            .im24
  3434.                            .im32
  3435.  
  3436.           Creator          Sun Microsystems, Inc.
  3437.  
  3438.           Used by          Sun workstations
  3439.  
  3440.           Variations       Reads 1, 8, 24, and 32 bit Standard, BGR, RGB,
  3441.                            and Byte Encoded (RLE) files.
  3442.  
  3443.                            Writes 1, 8, and 32 bit Standard files.
  3444.  
  3445.           Limitations      For a short time a version of the PBM toolkit
  3446.                            wrote Sun Raster files which had the wrong RGB
  3447.                            order.  Unfortunately there seem to be many
  3448.                            images which were generated with this incorrect
  3449.                            RGB order.  Please be aware that Alchemy's Sun
  3450.                            Raster reading and writing capability has been
  3451.                            extensively tested and compared to various other
  3452.                            tools; the RGB order is correct.
  3453.  
  3454.           Comments         Sun Raster files are normally not compressed and
  3455.                            so take up lots of disk space.
  3456.  
  3457.                            There is no standard extension for Sun Raster
  3458.                            files; the extensions that Alchemy uses seem to
  3459.                            be the most common.
  3460.  
  3461.           Example          Convert the SGI file sgiout to a sun raster file
  3462.                            called sun.im8:
  3463.  
  3464.                                 alchemy -s sgiout sun.im8
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-39
  3475.  
  3476.  
  3477.  
  3478.           Tagged Interchange File Format (TIFF)                          -t
  3479.  
  3480.  
  3481.                            TIFF is designed to be a universal raster image
  3482.                            format; it's very popular with desktop
  3483.                            publishing packages.
  3484.  
  3485.           Syntax           -t compressionType
  3486.  
  3487.           Parameter        compressionType:
  3488.                                 0:None
  3489.                                 1:LZW
  3490.                                 2:PackBits
  3491.                                 3:Group III Fax
  3492.                                 4:Group IV Fax
  3493.                                 5:CCITT RLE
  3494.                            The default is LZW Compression.
  3495.  
  3496.           Extensions       .tiff
  3497.                            .tif
  3498.  
  3499.           Creator          Aldus Corp.
  3500.                            Microsoft Corp.
  3501.  
  3502.           Used by          Various desktop publishing and scanning
  3503.                            software.
  3504.  
  3505.           Variations       Reads TIFF class B, G, R, and most class P
  3506.                            files.
  3507.  
  3508.                            Reads 1, 4, 8, 12, 24, and 32 bit images
  3509.                            (ignoring the alpha channel for 32 bit images).
  3510.  
  3511.                            Input compression types supported are raw, LZW,
  3512.                            PackBits, Group III fax, Group IV fax, CCITT RLE
  3513.                            (byte and word aligned), NeXT, Thunderscan,
  3514.                            PICIO, and SGI RLE.
  3515.  
  3516.                            Writes class B, G, P, and R files, depending on
  3517.                            the input file and options specified.
  3518.  
  3519.                            Writes 1, 4, 8, and 24 bit images.
  3520.  
  3521.           Limitations      Class P TIFF files can only be read if they have
  3522.                            1, 4, or 8 bits per pixel.
  3523.  
  3524.           Comments         1,4, and 8 bit output files are paletted unless
  3525.                            the palette is all gray, in which case the
  3526.                            output is a gray-scale file.
  3527.  
  3528.                            If you have TIFF files with 3, 5, 6, or 7 bits
  3529.                            per pixel please contact us.
  3530.  
  3531.  
  3532.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-40
  3533.  
  3534.  
  3535.  
  3536.           Example          Convert the file input.gif to an uncompressed
  3537.                            gray-scale TIFF file called output.tif:
  3538.  
  3539.                                 alchemy -t0 -b input.gif output.tif
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-41
  3591.  
  3592.  
  3593.  
  3594.           Targa                                                          -a
  3595.  
  3596.  
  3597.                            Targa files were created to support the line of
  3598.                            Targa graphics cards.  The Targa format is
  3599.                            popular with scanners and high end paint
  3600.                            packages.
  3601.  
  3602.           Syntax           -a outputType
  3603.  
  3604.           Parameter        outputType:
  3605.                                 0:uncompressed
  3606.                                 1:Run Length Coded
  3607.                                 10:uncompressed, no footer
  3608.                                 11:Run Length Coded, no footer
  3609.                            The default is 0 (uncompressed).
  3610.  
  3611.           Extension        .tga
  3612.  
  3613.           Creator          Truevision, Inc.
  3614.  
  3615.           Used by          Various scanning and paint software.
  3616.  
  3617.           Variations       Reads 8, 15, 16, 24, and 32 bit images, ignoring
  3618.                            the alpha channel for 32 bit images.
  3619.  
  3620.                            Writes 8, 15, 16, 24, and 32 bit images, writing
  3621.                            an empty alpha channel for 32 bit images.
  3622.  
  3623.           Comments         15 and 16 bit output are actually the same
  3624.                            except for one field in the header.
  3625.  
  3626.                            Targa files allow a footer containing additional
  3627.                            information such as aspect ratio.  However some
  3628.                            software is unable to read Targa files which
  3629.                            have a footer, so Alchemy allows all valid
  3630.                            combinations to be written.  The most common
  3631.                            variant for software to be able to read is 24
  3632.                            bit uncompressed (specify -a0 and -24).
  3633.  
  3634.           Example          Convert the file input.tif to an uncompressed 24
  3635.                            bit Targa file:
  3636.  
  3637.                                 alchemy input.tif -a -24
  3638.  
  3639.                            Convert the file input.tif to an uncompressed 15
  3640.                            bit Targa file called output.tga with no footer:
  3641.  
  3642.                                 alchemy -a10 -15 input.tif output.tga
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-42
  3649.  
  3650.  
  3651.  
  3652.           Utah Raster Toolkit (RLE)                                     --u
  3653.  
  3654.  
  3655.                            The Utah Raster Toolkit is a set of public
  3656.                            domain utilities for manipulating and converting
  3657.                            images for various workstations.  The source
  3658.                            code is freely available (see below).
  3659.  
  3660.           Syntax           --u
  3661.  
  3662.           Extension        .rle
  3663.  
  3664.           Creator          The University of Utah
  3665.                            The University of Michigan
  3666.  
  3667.           Used by          Utah RLE toolkit
  3668.  
  3669.           Variations       Reads and writes 1 and 3 channel 8 bits per
  3670.                            pixel files; the Alpha Channel is ignored during
  3671.                            reading.
  3672.  
  3673.           Limitations      While reading, files which are 1 channel and
  3674.                            have either no colour map or a single channel
  3675.                            colour map are assumed to be gray-scale images.
  3676.                            The colour map, if present, will be used as a
  3677.                            gamma correction table.
  3678.  
  3679.                            Files which are 1 channel and have a 3 channel
  3680.                            colour map are assumed to be paletted colour
  3681.                            files.
  3682.  
  3683.                            Files which are 3 channel are assumed to be true
  3684.                            colour.
  3685.  
  3686.                            When writing RLE files Alchemy will generate a 1
  3687.                            channel file with a 3 channel colour map for
  3688.                            paletted images and a 3 channel file with no
  3689.                            colour map for true colour images.
  3690.  
  3691.           Comments         Alchemy does not write optimally compressed
  3692.                            images.
  3693.  
  3694.                            The Utah Raster Toolkit is available free of
  3695.                            charge as pub/urt-3.0.tar.Z via anonymous ftp
  3696.                            from cs.utah.edu, weedeater.math.yale.edu, or
  3697.                            freebie.engin.umich.edu or via floppy disk from
  3698.                            us.
  3699.  
  3700.           Example          Convert the PBM file, image.ppm, to a Utah RLE
  3701.                            file:
  3702.  
  3703.                                 alchemy image.ppm --U
  3704.  
  3705.  
  3706.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-43
  3707.  
  3708.  
  3709.  
  3710.           Vivid                                                         --I
  3711.  
  3712.  
  3713.                            Vivid is a shareware ray-tracer for MS-DOS
  3714.                            computers
  3715.  
  3716.           Syntax           --I (upper case i)
  3717.  
  3718.           Extension        .img
  3719.  
  3720.           Creator          Steven B. Coy
  3721.  
  3722.           Used by          Vivid Ray Tracer
  3723.  
  3724.           Variations       Reads and writes 24 bit RLE files.
  3725.  
  3726.           Comments         The Vivid Ray Tracer is a shareware program for
  3727.                            PCs and is available from
  3728.                                 Stephen Coy
  3729.                                 15205 NE 13th Pl., #2904
  3730.                                 Bellevue, WA  98007
  3731.  
  3732.           Example          Convert the file spheres.qrt to a Vivid file:
  3733.  
  3734.                                 alchemy spheres.qrt --I
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-44
  3765.  
  3766.  
  3767.  
  3768.           Windows Bitmap (BMP)                                           -w
  3769.  
  3770.  
  3771.                            Windows BMP files are used by Microsoft Windows.
  3772.  
  3773.           Syntax           -w compressionType
  3774.  
  3775.           Parameter        compressionType:
  3776.                                 0:None
  3777.                                 1:RLE
  3778.                            The default is none.
  3779.  
  3780.           Extension        .bmp
  3781.  
  3782.           Creator          Microsoft Corp.
  3783.  
  3784.           Used by          Microsoft Windows
  3785.  
  3786.           Variations       Reads 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  3787.                            RLE8 files.
  3788.  
  3789.                            Writes 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  3790.                            RLE8 files.
  3791.  
  3792.           Limitations      Several of the programs which read and write RLE
  3793.                            files do not do so correctly; we do not
  3794.                            recommend writing RLE files unless you have
  3795.                            verified that they work with your intended
  3796.                            application.
  3797.  
  3798.           Comments         Microsoft supplied Windows 3.0 utilities cannot
  3799.                            read RLE4 or RLE8 files.
  3800.  
  3801.                            If you are converting an image to use as
  3802.                            wallpaper on a 16 colour Windows display you
  3803.                            will want to match the palette of the output
  3804.                            image to one of the existing 16 colour BMP
  3805.                            images supplied with Windows (chess.bmp, for
  3806.                            example).  If you do not do this the wallpaper
  3807.                            will not be loaded correctly.  See the example
  3808.                            section below for an example.
  3809.  
  3810.           Related options  -f   Match to existing palette
  3811.  
  3812.           Examples         Convert the image test.gif to a 16 colour
  3813.                            Windows BMP file to be used as wallpaper (the
  3814.                            file chess.bmp is supplied with Windows; this
  3815.                            example assumes that it is in the current
  3816.                            directory):
  3817.  
  3818.                                 alchemy test.gif -f chess.bmp -w
  3819.  
  3820.  
  3821.  
  3822.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-45
  3823.  
  3824.  
  3825.  
  3826.           WordPerfect Graphic File                                       -W
  3827.  
  3828.  
  3829.                            WordPerfect files are images which can be
  3830.                            imported into WordPerfect and various other word
  3831.                            processors and desktop publishing programs.
  3832.  
  3833.           Syntax           -W
  3834.  
  3835.           Extension        .wpg
  3836.  
  3837.           Creator          WordPerfect Corp.
  3838.  
  3839.           Used by          WordPerfect
  3840.  
  3841.           Variations       1 through 8 bits per pixel are supported.
  3842.  
  3843.           Limitations      Alchemy does not write optimally compressed
  3844.                            files.
  3845.  
  3846.                            Files with default palettes are not read
  3847.                            correctly.
  3848.  
  3849.           Comments         In addition to raster images WordPerfect files
  3850.                            may contain vectors and text information.  Such
  3851.                            information is lost when reading WordPerfect
  3852.                            files.
  3853.  
  3854.           Example          Convert the image, newpict.pcx, to a black and
  3855.                            white WPG file:
  3856.  
  3857.                                 alchemy newpict.pcx -b -c2 -W
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-46
  3881.  
  3882.  
  3883.  
  3884.           XBM                                                           --b
  3885.  
  3886.  
  3887.                            XBM files are used by the X Windowing System.
  3888.                            XBM files are C source code files which can be
  3889.                            read and written by various X utilities and are
  3890.                            designed to be included in C source code for use
  3891.                            as icons and other bit-mapped graphic images.
  3892.  
  3893.           Syntax           --b
  3894.  
  3895.           Extensions       .xbm
  3896.                            .bm
  3897.  
  3898.           Creator          MIT
  3899.  
  3900.           Used by          The X Windowing system
  3901.  
  3902.           Variations       1 bit per pixel
  3903.  
  3904.           Limitations      Because .xbm files are actually C source code
  3905.                            files there can be many variations of .xbm
  3906.                            files.  Since adding a C preprocessor to Alchemy
  3907.                            to handle all the theoretically allowable .xbm
  3908.                            files is impractical we have instead designed
  3909.                            Alchemy to interchange .xbm files with the PBM
  3910.                            utilities and the X supplied utilities, and to
  3911.                            read the sample .xbm files from Sun
  3912.                            Microsystems.  If you run across any .xbm files
  3913.                            which Alchemy can not read please contact us.
  3914.  
  3915.                            The hotspot field is ignored when reading .xbm
  3916.                            files.
  3917.  
  3918.           Comments         Most of the X supplied utilities (bitmap, for
  3919.                            example) are designed to edit small .xbm images.
  3920.  
  3921.  
  3922.  
  3923.           Example          Convert the file picture.im32 to an XBM file
  3924.                            using high quality scaling and preserving the
  3925.                            aspect ratio:
  3926.  
  3927.                                 alchemy --b -Xb64 -+ picture.im32
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-47
  3939.  
  3940.  
  3941.  
  3942.           XWD                                                           --w
  3943.  
  3944.  
  3945.                            XWD is the file format used by xwd, the X window
  3946.                            dumping utility.
  3947.  
  3948.           Syntax           --w
  3949.  
  3950.           Extension        .xwd
  3951.  
  3952.           Creator          MIT
  3953.  
  3954.           Used by          The X Windowing System
  3955.  
  3956.           Variations       1, 8, and 24 bits per pixel.
  3957.  
  3958.           Limitations      XY format files are not supported.
  3959.  
  3960.           Example          Convert the XBM file, icon.xbm, to an XWD file:
  3961.  
  3962.                                 alchemy icon.xbm --w
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    3-48
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.                                                                           4
  4003.  
  4004.  
  4005.  
  4006.           General Options
  4007.           -----------------------------------------------------------------          -----------------------------------------------------------------
  4008.  
  4009.  
  4010.           Introduction     General options are options which do not affect
  4011.                            the conversion of the image.  They control such
  4012.                            things as the overwriting of existing files and
  4013.                            the way that memory is used.
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-1
  4055.  
  4056.  
  4057.  
  4058.           Conserve Memory                                                -$
  4059.  
  4060.  
  4061.           Purpose          Use as little memory as possible when converting
  4062.                            images.
  4063.  
  4064.           Syntax           -$ (dollar sign)
  4065.  
  4066.           Comments         Normally Alchemy tries to work on chunks of the
  4067.                            image several lines long to improve performance.
  4068.                            Use of the -$ option will cause it to use the
  4069.                            smallest size chunks possible for the conversion
  4070.                            being performed.  On MS-DOS based systems this
  4071.                            will usually allow conversion of larger images
  4072.                            than would otherwise be possible.  On Unix
  4073.                            systems this may reduce paging when converting
  4074.                            very large images.
  4075.  
  4076.           Example          Convert the image giant.tga to a 16 colour TIFF
  4077.                            file conserving memory:
  4078.  
  4079.                                 alchemy giant.tga -$ -t -c16
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-2
  4113.  
  4114.  
  4115.  
  4116.           Display Image Stats                                            -x
  4117.  
  4118.  
  4119.           Purpose          Display image statistics.
  4120.  
  4121.           Syntax           -x
  4122.  
  4123.           Comments         Displays image type, size, number of colours,
  4124.                            aspect ratio, resolution, and compression ratio.
  4125.  
  4126.           Limitations      Can not be combined with other options.
  4127.  
  4128.           Example          Find out about the image called image.tga:
  4129.  
  4130.                                 alchemy -x image.tga
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-3
  4171.  
  4172.  
  4173.  
  4174.           Do not alter output filename                                   -.
  4175.  
  4176.  
  4177.           Purpose          Disable automatic appending of the output image
  4178.                            type to the output file name.
  4179.  
  4180.           Syntax           -. (period)
  4181.  
  4182.           Comments         By default, if there's no '.' in the output
  4183.                            filename, Alchemy will add an extension
  4184.                            indicating the type of file.  If the -. option
  4185.                            is specified no extension will be added.
  4186.  
  4187.                            This is most useful on non-MS-DOS systems where
  4188.                            '.' is not a special character in filenames.
  4189.  
  4190.           Example          Convert the file called infile.gif to a PCX file
  4191.                            called outfile (if you did not use the -. option
  4192.                            Alchemy would automatically change the output
  4193.                            file name to outfile.pcx):
  4194.  
  4195.                                 alchemy infile.gif outfile -p -.
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-4
  4229.  
  4230.  
  4231.  
  4232.           Help                                                           -h
  4233.  
  4234.  
  4235.           Purpose          Give you information on how to use Image
  4236.                            Alchemy.
  4237.  
  4238.           Syntax           -h option
  4239.  
  4240.           Parameter        option
  4241.                                 0: general help
  4242.                                 1: general options
  4243.                                 2: output formats a-k
  4244.                                 3: output formats l-z
  4245.                                 4: colour options
  4246.                                 5: scaling options
  4247.                                 6: display options (MS-DOS Only)
  4248.                            Default is 0, general help
  4249.  
  4250.           Comments         The help information given by this command is
  4251.                            only a summary.
  4252.  
  4253.           Limitations      The help option cannot be combined with any
  4254.                            other options.
  4255.  
  4256.           Related options  -?   support and update information
  4257.  
  4258.           Example          Get help on the colour options:
  4259.  
  4260.                                 alchemy -h4
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-5
  4287.  
  4288.  
  4289.  
  4290.           Overwrite                                                      -o
  4291.  
  4292.  
  4293.           Purpose          Force Alchemy to overwrite existing files on the
  4294.                            disk.
  4295.  
  4296.           Syntax           -o
  4297.  
  4298.           Comments         Image Alchemy will not overwrite an existing
  4299.                            file unless the -o option is specified.
  4300.  
  4301.           Limitations      The input file name and the output file name can
  4302.                            not be the same.
  4303.  
  4304.           Example          Convert the file input.tga to a GIF file called
  4305.                            output.gif, overwriting the existing file called
  4306.                            output.gif:
  4307.  
  4308.                                 alchemy input.tga -g output.gif -o
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-6
  4345.  
  4346.  
  4347.  
  4348.           Program information                                            -?
  4349.  
  4350.  
  4351.           Purpose          Give you information on how to get support for
  4352.                            Image Alchemy or inquire about update
  4353.                            information.
  4354.  
  4355.           Syntax           -?
  4356.  
  4357.           Comments         Sun-3 and Sun-4 users have to escape the
  4358.                            question mark with a back-slash (instead of -?
  4359.                            use -\?).  This is because the UNIX shell will
  4360.                            attempt to perform wildcard expansion on the
  4361.                            question mark.
  4362.  
  4363.           Limitations      The information option cannot be combined with
  4364.                            any other options.
  4365.  
  4366.           Related options  -h   help with commands
  4367.  
  4368.           Example          Get support information:
  4369.  
  4370.                                 alchemy -?
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-7
  4403.  
  4404.  
  4405.  
  4406.           Quiet                                                          -Q
  4407.  
  4408.  
  4409.           Purpose          Suppress all status messages (but not error
  4410.                            messages).
  4411.  
  4412.           Syntax           -Q
  4413.  
  4414.           Comments         This is useful when running Alchemy in the
  4415.                            background on Unix systems or in batch files on
  4416.                            MS-DOS systems (and you don't want the output of
  4417.                            Alchemy scrolling important messages off of the
  4418.                            screen).
  4419.  
  4420.           Limitations      There is no way to suppress error messages.
  4421.  
  4422.           Example          Convert the file dummy.gif to a PCX file but
  4423.                            don't report any status messages:
  4424.  
  4425.                                 alchemy -Q dummy.gif -p
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-8
  4461.  
  4462.  
  4463.  
  4464.           Wildcard                                                       --
  4465.  
  4466.  
  4467.           Purpose          Allow the conversion of multiple files with a
  4468.                            single execution of Alchemy.
  4469.  
  4470.           Syntax           -- (dash)
  4471.  
  4472.           Comments         The wildcard option allows you to specify
  4473.                            multiple file names and file names which include
  4474.                            wild card characters.  Alchemy will perform the
  4475.                            same conversion for each input file name that it
  4476.                            finds.
  4477.  
  4478.                            On MS-DOS systems the use of the wildcard option
  4479.                            (--) is not required if the first file name
  4480.                            specified includes a wildcard character (* or
  4481.                            ?); however to reduce confusion it is still
  4482.                            recommended.
  4483.  
  4484.           Limitations      The wildcard option (--) must be specified
  4485.                            before any file names.
  4486.  
  4487.                            If you are using the wildcard option you may not
  4488.                            specify an output file name;  the file names are
  4489.                            automatically generated by substituting an
  4490.                            appropriate extension to the input file names.
  4491.                            If you do specify an output file name it will be
  4492.                            misinterpreted as another input file.  An output
  4493.                            path name may still be specified.
  4494.  
  4495.                            Any error will terminate the execution of
  4496.                            Alchemy; any images which appear in the filename
  4497.                            list after the one causing the error will not be
  4498.                            processed.  This includes attempting to
  4499.                            overwrite an already existing file without
  4500.                            specifying the -o option.
  4501.  
  4502.                            Alchemy does not intelligently retain
  4503.                            information between files.  For example, if you
  4504.                            are matching a group of files to an existing
  4505.                            palette, the inverse palette generation step
  4506.                            only needs to be performed once, but it is in
  4507.                            fact done for each file.  This only affects the
  4508.                            speed of conversions, not the quality.
  4509.  
  4510.  
  4511.           Examples         Convert all the GIF files in the current
  4512.                            directory to JPEG files:
  4513.  
  4514.                                 alchemy  --  *.gif  -j
  4515.  
  4516.  
  4517.  
  4518.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     4-9
  4519.  
  4520.  
  4521.  
  4522.                            Convert all the TIFF files in the directory
  4523.                            \tiff to PCX files in the directory
  4524.                            \images\output:
  4525.  
  4526.                                 alchemy  --  \tiff\*.tif -p \images\output
  4527.  
  4528.                            Convert the files madonna.gif, bay4.gif,
  4529.                            everest.tga, and basil.tif to JPEG files,
  4530.                            overwriting any existing files:
  4531.  
  4532.                                 alchemy  --  -o madonna.gif bay4.gif -j
  4533.                                 everest.tga basil.tif
  4534.  
  4535.                            Convert the files test1.tif, test2.tif, and
  4536.                            new*.gif to ILBM files, matching them to the
  4537.                            palette from the file output.pal:
  4538.  
  4539.                                 alchemy  --  test1.tif test2.tif new*.gif -
  4540.                                 f output.pal -i
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    4-10
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.                                                                           5
  4583.  
  4584.  
  4585.  
  4586.           Colour and Palette Options
  4587.           -----------------------------------------------------------------          -----------------------------------------------------------------
  4588.  
  4589.  
  4590.           Introduction     Colour and Palette options are options which
  4591.                            affect the appearance of the output image.  They
  4592.                            control such things as the number of colours in
  4593.                            the output image and the dithering techniques
  4594.                            used.
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-1
  4635.  
  4636.  
  4637.  
  4638.           Black and White                                                -b
  4639.  
  4640.  
  4641.           Purpose          Convert the image to black and white.
  4642.  
  4643.           Syntax           -b
  4644.  
  4645.           Comments         In conjunction with the -b option the -c option
  4646.                            is used to specify the number of shades of gray
  4647.                            in the image.  The default is 256 shades of gray
  4648.                            when converting from a true colour image.  When
  4649.                            converting from a paletted image the number of
  4650.                            shades of gray defaults to the number of colours
  4651.                            in the original image.
  4652.  
  4653.                            The shades of gray are uniformly distributed
  4654.                            from 0 to 255.
  4655.  
  4656.                            When converting from true colour the image will
  4657.                            be changed to a paletted image unless the -24
  4658.                            option is used.
  4659.  
  4660.           Related options  -8   Paletted output
  4661.                            -24  True colour output
  4662.                            -c   Specify number of colours
  4663.  
  4664.           Examples         Convert the file sample.jpg into a 256 shades of
  4665.                            gray raw file:
  4666.  
  4667.                                 alchemy sample.jpg -b -r
  4668.  
  4669.                            Convert the file madonna.jpg into a 4 shades of
  4670.                            gray gif file called gray.gif:
  4671.  
  4672.                                 alchemy -b -c4 -g madonna.gif gray.gif
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-2
  4693.  
  4694.  
  4695.  
  4696.           Colours                                                        -c
  4697.  
  4698.  
  4699.           Purpose          Specify the number of colours for the output
  4700.                            file.
  4701.  
  4702.           Syntax           -c colours [reserveColours]
  4703.  
  4704.           Parameters       colours
  4705.                                 Specifies the number of colours in the
  4706.                            output image.  May be between 2 and 256.
  4707.  
  4708.                            reserveColours
  4709.                                 Specifies the number of colours to reserve
  4710.                            in the output image.  May be between 0 and 255.
  4711.  
  4712.           Comments         If the input file has a larger number of colours
  4713.                            than specified for the output file, the image
  4714.                            will be quantized using Heckbert's median cut
  4715.                            algorithm and dithered.  For further information
  4716.                            on Heckbert's median cut algorithm see Appendix
  4717.                            B, Colour and Dithering.
  4718.  
  4719.                            The number of colours to reserve is an optional
  4720.                            parameter.  If it is present it causes the
  4721.                            specified number of colours to be reserved from
  4722.                            the beginning of the palette.  The output image
  4723.                            will not contain any of those colour indices.
  4724.                            This can be useful if you have menus or other
  4725.                            information you wish to display at the same time
  4726.                            as the images and they use colours at the
  4727.                            beginning of the palette.  The menu colours will
  4728.                            then not interfere with the image.  The first
  4729.                            indices are set to black unless 16 is specified,
  4730.                            in which case they are set to the standard VGA
  4731.                            colour palette.
  4732.  
  4733.           Limitations      Specifying the number of colours only has an
  4734.                            effect if you are writing a paletted file (using
  4735.                            the -8 option) or if the output file type is
  4736.                            always paletted.
  4737.  
  4738.                            Converting an image with a large number of
  4739.                            colours to a small number of colours (less than
  4740.                            8) will usually give poor results.
  4741.  
  4742.                            The reserved colours will be set to black unless
  4743.                            16 colours are reserved.  In that case they will
  4744.                            be set to the standard VGA colours.
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-3
  4751.  
  4752.  
  4753.  
  4754.           Related options  -8   Convert to paletted image
  4755.                            -d   Specify dither type
  4756.                            -u   Use uniform palette
  4757.  
  4758.           Examples         Convert the image colours.gif into a 16 colour
  4759.                            PCX file called colour16.pcx
  4760.  
  4761.                                 alchemy colours.gif -p -c16 colour16.pcx
  4762.  
  4763.                            Convert the image colours.tga into a 256 colour
  4764.                            GIF file called output.gif, reserving the first
  4765.                            16 colours.
  4766.  
  4767.                                 alchemy colours.tga -g -c256 16 output.gif
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-4
  4809.  
  4810.  
  4811.  
  4812.           Dither                                                         -d
  4813.  
  4814.  
  4815.           Purpose          Specifies the type of dithering to apply to the
  4816.                            image.
  4817.  
  4818.           Syntax           -d[s] ditherType [perturbation]
  4819.  
  4820.           Parameters       If the -d is immediately followed by an 's',
  4821.                            then a serpentine raster is used.
  4822.  
  4823.                            ditherType can be:
  4824.                                 0:None
  4825.                                 1:Floyd-Steinberg
  4826.                                 2:Stucki
  4827.                                 3:Jarvis, Judice, & Ninke
  4828.                            The default is Floyd-Steinberg.
  4829.  
  4830.                            perturbation
  4831.                                 0 through 127
  4832.                            The default is 0.
  4833.  
  4834.           Comments         Dithering is used to reduce colour banding in an
  4835.                            image caused by the palette not having a perfect
  4836.                            match for every colour in the image.
  4837.  
  4838.                            Floyd-Steinberg is the fastest supported
  4839.                            dithering algorithm and usually produces the
  4840.                            best results.  Stucki and Jarvis, Judice, &
  4841.                            Ninke both tend to cause an image to appear more
  4842.                            grainy on low resolution output devices (such as
  4843.                            CRTs).  However they produce better results than
  4844.                            Floyd-Steinberg on high-resolution, low colour
  4845.                            output devices such as laser printers.
  4846.  
  4847.                            The -d option only has an effect if the number
  4848.                            of colours is being reduced or the image is
  4849.                            being re-mapped to a new palette.
  4850.  
  4851.                            Specifying a perturbation adds noise to the
  4852.                            threshold used for dithering, which can help
  4853.                            break up visible patterns introduced by
  4854.                            dithering.  The parameter specifies the
  4855.                            magnitude of the noise.
  4856.  
  4857.                            Using a serpentine raster can also help to
  4858.                            reduce visible patterns introduced by dithering.
  4859.  
  4860.                            For further information on dithering see
  4861.                            Appendix B, Colour and Dithering.
  4862.  
  4863.  
  4864.  
  4865.  
  4866.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-5
  4867.  
  4868.  
  4869.  
  4870.           Examples         Convert the 256 colour file image.gif to a 16
  4871.                            colour PCX file using a uniform palette and no
  4872.                            dithering:
  4873.  
  4874.                                 alchemy image.gif -p -c16 -d0 -u
  4875.  
  4876.                            Convert the true colour image sample.jpg into a
  4877.                            256 colour GIF file called sample.gif, using
  4878.                            Stucki dithering:
  4879.  
  4880.                                 alchemy -g -d2 sample.jpg
  4881.  
  4882.                            Convert the 256 colour image sample.gif into a
  4883.                            one bit black and white PCL file called
  4884.                            sample.pcl, using Jarvis, Judice, and Ninke
  4885.                            dithering, a serpentine raster, and a little
  4886.                            noise:
  4887.  
  4888.                                 alchemy -P -b -c2  -ds3 20 sample.gif
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-6
  4925.  
  4926.  
  4927.  
  4928.           EGA Palette                                                    -E
  4929.  
  4930.  
  4931.           Purpose          Optimize the image quality for display on an EGA
  4932.                            board and monitor.
  4933.  
  4934.           Syntax           -E
  4935.  
  4936.           Comments         If you are converting images to display on an
  4937.                            EGA board and monitor this option will optimize
  4938.                            the image quality.
  4939.  
  4940.                            This option reduces the palette resolution to
  4941.                            two bits and automatically specifies the
  4942.                            following:  -8 -c16 -z0 2 0.
  4943.  
  4944.           Limitations      The number of colours in an EGA palette must be
  4945.                            less than or equal to 16;  the number of colours
  4946.                            defaults to 16 but can be reduced by using the -
  4947.                            c option.
  4948.  
  4949.           Related options  -c   specify number of colours
  4950.  
  4951.           Example          Convert the image dave1.tga into dave1.pcx, a
  4952.                            PCX file with a palette optimized for EGA use:
  4953.  
  4954.                                 alchemy -E -p dave1.tga
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-7
  4983.  
  4984.  
  4985.  
  4986.           False Colour                                                   -F
  4987.  
  4988.  
  4989.           Purpose          False colour an image using the palette from a
  4990.                            file.  The input image will be changed to use
  4991.                            the palette found in the specified filename but
  4992.                            no attempt at picking the best match will be
  4993.                            done.
  4994.  
  4995.           Syntax           -F filename
  4996.  
  4997.           Parameter        filename
  4998.                                 Any valid image type which contains a
  4999.                            palette
  5000.  
  5001.           Comments         This feature can be used to add false colour to
  5002.                            monochrome images.  The output file is not
  5003.                            dithered.  This is only applicable to paletted
  5004.                            input files.
  5005.  
  5006.           Limitations      Can not be combined with spiff -S or match to
  5007.                            palette -f.
  5008.  
  5009.           Example          False colour the file scan.gif using the palette
  5010.                            from the file colorful.pcx, creating the GIF
  5011.                            file new.gif:
  5012.  
  5013.                                 alchemy -F colorful.pcx -g scan.gif new.gif
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-8
  5041.  
  5042.  
  5043.  
  5044.           Match Palette                                                  -f
  5045.  
  5046.  
  5047.           Purpose          Match the output to a palette read from a file.
  5048.                            The input image will be re-mapped to use the
  5049.                            palette found in the specified file.
  5050.  
  5051.           Syntax           -f filename
  5052.  
  5053.           Parameter        filename
  5054.                                 Any valid image type which contains a
  5055.                            palette
  5056.  
  5057.           Comments         Using the -f option will cause the output image
  5058.                            to be dithered (unless you specify no dithering
  5059.                            by using the -d0 option).
  5060.  
  5061.                            The -f option can be useful if you are combining
  5062.                            several images into a collage or want to match
  5063.                            an image to a pre-existing palette.  You can
  5064.                            also create a custom palette from scratch by
  5065.                            using a text editor and creating a .PAL file.
  5066.  
  5067.           Limitations      Cannot be combined with spiff -S or false colour
  5068.                            -F.
  5069.  
  5070.                            The number of colours in the final image will be
  5071.                            equal to the number of colours in the palette
  5072.                            being read in.
  5073.  
  5074.                            The specified file must contain a palette (i.e.
  5075.                            cannot be true colour).
  5076.  
  5077.           Related options  -l   Generate palette file
  5078.                            -F   False colour
  5079.                            -d   Dither
  5080.  
  5081.  
  5082.  
  5083.           Examples         Convert the image bigimage.tif to a pcx file
  5084.                            using the palette from the file standard.pal:
  5085.  
  5086.                                 alchemy bigimage.tif -p -f standard.pal
  5087.  
  5088.                            Convert the image colour.gif to a gif file
  5089.                            called colour2.gif using the palette from the
  5090.                            file newpal.gif:
  5091.  
  5092.                                 alchemy -fnewpal.gif -g colour.gif colour2
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     5-9
  5099.  
  5100.  
  5101.  
  5102.           Palette                                                        -8
  5103.  
  5104.  
  5105.           Purpose          Force the output image to be paletted.
  5106.  
  5107.           Syntax           -8
  5108.  
  5109.           Comments         This option is -8 because paletted images are
  5110.                            typically 8 bits per pixel.
  5111.  
  5112.                            Alchemy defaults to the -8 option if the input
  5113.                            file is paletted or gray-scale.
  5114.  
  5115.                            Some file formats require files to be paletted;
  5116.                            for those formats the -8 option is assumed.
  5117.                            Some file formats do not have a paletted
  5118.                            variation; in those cases the -8 option will be
  5119.                            ignored if specified.  Some file formats only
  5120.                            allow gray-scale files to be 8 bit; in those
  5121.                            cases Alchemy will ignore the -8 option if the
  5122.                            image being written is not gray-scale.
  5123.  
  5124.                            The actual number of bits per pixel is
  5125.                            determined by the -c option (below).
  5126.  
  5127.                            If the input file is true colour the output file
  5128.                            will be quantized and dithered (see the -c and -
  5129.                            d options below).
  5130.  
  5131.           Related options  -15  True colour output
  5132.                            -16  True colour output
  5133.                            -24  True colour output
  5134.                            -32  True colour output
  5135.                            -c   specify number of colours in image
  5136.                            -d   dither
  5137.  
  5138.           Examples         Convert the JPEG file bigimage.jpg into a
  5139.                            paletted TIFF file with 256 colours:
  5140.  
  5141.                                 alchemy -8 -t bigimage.jpg
  5142.  
  5143.                            Convert the Targa file madonna.tga to a 16
  5144.                            colour PCX file (note that the -8 option is
  5145.                            implied by the use of the    -c16 option):
  5146.  
  5147.                                 alchemy -c16 -p madonna.tga
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-10
  5157.  
  5158.  
  5159.  
  5160.           Palette Selection                                              -z
  5161.  
  5162.  
  5163.           Purpose          Control how the palette is generated.  These
  5164.                            options only have an effect if the palette is
  5165.                            being generated by Alchemy using Heckbert's
  5166.                            median cut algorithm.
  5167.  
  5168.           Syntax           -z sortType [selectionType [swapType] ]
  5169.  
  5170.           Parameters       Sort the image palette.  SortType can be:
  5171.                                 0:None
  5172.                                 1:popularity
  5173.                                 2:luminance (white to black)
  5174.                                 3:rgb
  5175.                                 4:luminance (black to white)
  5176.                            The default is None.
  5177.  
  5178.                            SelectionType can be:
  5179.                                 0:mean
  5180.                                 1:median
  5181.                                 2:corner
  5182.                            The default is mean.
  5183.  
  5184.                            See Appendix B, Colour and Dithering, for an
  5185.                            explanation of these choices.
  5186.  
  5187.                            SwapType can be:
  5188.                                 0:None
  5189.                                 1:IBM (colour 0 is black, 7 is white)
  5190.                                 2:Macintosh (colour 0 is white, 255 is
  5191.                            black)
  5192.                                 3:Sun (colour 0 is white, 1 is black)
  5193.                            The default is based on the file type being
  5194.                            written out (IBM for GIF, Macintosh for Mac
  5195.                            PICT, Sun for Sun Raster, and None for all
  5196.                            others).
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-11
  5215.  
  5216.  
  5217.  
  5218.           Comments         The most common use for this option is to sort
  5219.                            the palette; in this case only a single
  5220.                            parameter is needed.
  5221.  
  5222.                            This option only affects palettes that are
  5223.                            generated by Alchemy.  To sort an existing
  5224.                            palette you can save the image as a true colour
  5225.                            file (such as HSI Raw, by using the -24 -r
  5226.                            options) and then convert that back to a
  5227.                            paletted file, specifying the desired sort type.
  5228.                            In most cases this will not change the image
  5229.                            (other than the palette order); however if the
  5230.                            palette had entries representing colours that
  5231.                            are nearly identical then the image may be
  5232.                            modified.
  5233.  
  5234.           Limitations      Note that it is not possible to specify a
  5235.                            swapType without first specifying both a
  5236.                            sortType and a selectionType.  See Appendix B,
  5237.                            Colour and Dithering, for more information.
  5238.  
  5239.           Example          Convert the file input.tga to a gif filed called
  5240.                            output.gif sorting the colours by luminance,
  5241.                            using the mean of the Heckbert box for the
  5242.                            colour, and moving the colours around so that
  5243.                            the lightest colour is colour 0 and the darkest
  5244.                            colour is colour 1.
  5245.  
  5246.                                 alchemy input.tga -g output.gif -z4 0 3
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-12
  5273.  
  5274.  
  5275.  
  5276.           Spiff                                                          -S
  5277.  
  5278.  
  5279.           Purpose          Enhance the image contrast by stretching the
  5280.                            pixel colour values to the full 0 to 255 range.
  5281.  
  5282.           Syntax           -S
  5283.  
  5284.           Comments         This command can be used if the image you are
  5285.                            converting is shifted in brightness or squished
  5286.                            in contrast.  This can happen if you scan or
  5287.                            digitize a very dark or very bright image.
  5288.  
  5289.           Limitations      The -S option can not be used at the same time
  5290.                            as the -b option when converting from a true
  5291.                            colour image.  A work around is to do the
  5292.                            operation in two steps, converting it to black
  5293.                            and white first and then spiffing the resulting
  5294.                            image.
  5295.  
  5296.                            Using the spiff option at the same time as the
  5297.                            match palette, -f, or false colour, -F, options
  5298.                            is not allowed.  This is because the spiff
  5299.                            option would be performed before the palette is
  5300.                            changed, which would nullify the effects.  A
  5301.                            work around is to do the matching or false
  5302.                            colouring first, and then spiff the resultant
  5303.                            image.
  5304.  
  5305.           Related options  -b   Black and White
  5306.                            -f   Match palette
  5307.                            -F   False colour image
  5308.  
  5309.           Example          Convert the file gloomy.pcx into a PCX file
  5310.                            called better.pcx:
  5311.  
  5312.                                 alchemy gloomy.pcx -S -p better.pcx
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-13
  5331.  
  5332.  
  5333.  
  5334.           True Colour (15 bits)                                         -15
  5335.  
  5336.  
  5337.           Purpose          Force the output image to be true colour, 15
  5338.                            bits (5 bits per component).
  5339.  
  5340.           Syntax           -15
  5341.  
  5342.           Comments         See the True Colour (24 bits) section, below.
  5343.  
  5344.           Related options  -8   Paletted output
  5345.                            -16  True colour output
  5346.                            -24  True colour output
  5347.                            -32  True colour output
  5348.  
  5349.           Example          Convert the GIF file test.gif into an
  5350.                            uncompressed, true colour 15 bit Targa file
  5351.                            called test.tga:
  5352.  
  5353.                                 alchemy test.gif -a0 -15
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-14
  5389.  
  5390.  
  5391.  
  5392.           True Colour (16 bits)                                         -16
  5393.  
  5394.  
  5395.           Purpose          Force the output image to be true colour, 16
  5396.                            bits (5 bits each for red and blue, 6 for
  5397.                            green).
  5398.  
  5399.           Syntax           -16
  5400.  
  5401.           Comments         See the True Colour (24 bits) section, below.
  5402.  
  5403.           Related options  -8   Paletted output
  5404.                            -15  True colour output
  5405.                            -24  True colour output
  5406.                            -32  True colour output
  5407.  
  5408.           Example          Convert the GIF file test.gif into an
  5409.                            uncompressed, true colour 16 bit Targa file
  5410.                            called test.tga:
  5411.  
  5412.                                 alchemy test.gif -a0 -16
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-15
  5447.  
  5448.  
  5449.  
  5450.           True Colour (24 bits)                                         -24
  5451.  
  5452.  
  5453.           Purpose          Force the output image to be true colour (not
  5454.                            paletted).
  5455.  
  5456.           Syntax           -24
  5457.  
  5458.           Comments         This option is -24 because true colour images
  5459.                            are typically 24 bits per pixel.
  5460.  
  5461.                            Some file formats require files to be true
  5462.                            colour; for those formats the -24 option is
  5463.                            assumed.  Some file formats only have a paletted
  5464.                            variation; in those cases the -24 option will be
  5465.                            ignored if specified.
  5466.  
  5467.                            The file formats which may be either true colour
  5468.                            or paletted default to true colour if the input
  5469.                            file is true colour.
  5470.  
  5471.                            Certain file formats may only be paletted if the
  5472.                            images are gray-scale, in those cases Alchemy
  5473.                            will automatically switch to true colour if the
  5474.                            output image is colour.
  5475.  
  5476.                            Converting a paletted image to true colour will
  5477.                            not improve its quality or change its
  5478.                            appearance.  The primary use of this option is
  5479.                            to force an image to be true colour when
  5480.                            converting to a format which allows either
  5481.                            paletted or true colour, but where the paletted
  5482.                            variation is not well supported (like the Targa
  5483.                            image format).
  5484.  
  5485.           Related options  -8   Paletted output
  5486.  
  5487.           Example          Convert the GIF file test.gif into an
  5488.                            uncompressed, true colour Targa file called
  5489.                            test.tga:
  5490.  
  5491.                                 alchemy test.gif -a0 -24
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.  
  5499.  
  5500.  
  5501.  
  5502.  
  5503.  
  5504.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-16
  5505.  
  5506.  
  5507.  
  5508.           True Colour (32 bits)                                         -32
  5509.  
  5510.  
  5511.           Purpose          Force the output image to be true colour, 32
  5512.                            bits (8 bits per component, 8 bits for alpha).
  5513.  
  5514.           Syntax           -32
  5515.  
  5516.           Comments         See the True Colour (24 bits) section, above.
  5517.  
  5518.           Related options  -8   Paletted output
  5519.                            -15  True colour output
  5520.                            -16  True colour output
  5521.                            -24  True colour output
  5522.  
  5523.           Example          Convert the GIF file test.gif into an
  5524.                            uncompressed, true colour 32 bit Targa file
  5525.                            called test.tga (the alpha channel will be
  5526.                            empty):
  5527.  
  5528.                                 alchemy test.gif -a0 -32
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-17
  5563.  
  5564.  
  5565.  
  5566.           Undercolour Removal                                            -C
  5567.  
  5568.  
  5569.           Purpose          Control the undercolour removal process, colour
  5570.                            correction, and density correction for output
  5571.                            formats which use the CMYK colour space.
  5572.  
  5573.           Syntax           -C filename
  5574.  
  5575.           Parameter        filename
  5576.                                 The name of the file which contains the
  5577.                            undercolour removal information
  5578.  
  5579.           Comments         The undercolour removal portion of the file is
  5580.                            compatible with the format used by Stork
  5581.                            Colorproofing B.V.  The format of this file is
  5582.                            described in Appendix G, Undercolour Removal
  5583.                            Files.
  5584.  
  5585.                            Sample undercolour removal files can be found in
  5586.                            the samples directory on the Alchemy
  5587.                            distribution disk or tape.
  5588.  
  5589.           Example          Convert the file image.tga to an HP RTL file
  5590.                            called image.rtl using the undercolour removal
  5591.                            file sample.ucr:
  5592.  
  5593.                                 alchemy image.tga --r4 -Csample.ucr
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.  
  5618.  
  5619.  
  5620.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-18
  5621.  
  5622.  
  5623.  
  5624.           Uniform Palette                                                -u
  5625.  
  5626.  
  5627.           Purpose          Use a Uniform Palette.
  5628.  
  5629.           Syntax           -u
  5630.  
  5631.           Comments         Instead of using the Heckbert median cut
  5632.                            algorithm to generate a custom palette for the
  5633.                            image, use a palette with entries which are
  5634.                            evenly distributed in the RGB colour cube.
  5635.  
  5636.                            The advantage of using a uniform palette is that
  5637.                            it's faster than generating a custom palette.
  5638.                            However, this is at the expense of image quality
  5639.                            since the palette isn't generated based on image
  5640.                            content.
  5641.  
  5642.                            When just viewing a true colour image on a
  5643.                            paletted display a uniform palette is used.
  5644.  
  5645.                            The -c option can be used in conjunction with -u
  5646.                            to specify the size of the uniform palette; in
  5647.                            that case Alchemy will generate a palette with
  5648.                            not more than the specified number of colours
  5649.                            (but not less than 8).
  5650.  
  5651.           Limitations      The palette size will not necessarily match the
  5652.                            specified size, as the actual size must be the
  5653.                            product of three integers.  Alchemy picks
  5654.                            integers that roughly correspond to the
  5655.                            sensitivity of the human eye to red, green, and
  5656.                            blue (30%, 59%, and 11%).
  5657.  
  5658.           Related options  -c   Specify number of colours
  5659.                            -d   Dither type
  5660.  
  5661.           Examples         Convert the file many.tga to a gif file using a
  5662.                            256 colour uniform palette:
  5663.  
  5664.                                 alchemy many.tga -g -u
  5665.  
  5666.                            Convert the file many.tga to a gif file with up
  5667.                            to 128 colours in a uniform palette:
  5668.  
  5669.                                 alchemy many.tga -g -u -c128
  5670.  
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.    5-19
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.                                                                           6
  5685.  
  5686.  
  5687.  
  5688.           Scaling Options
  5689.           -----------------------------------------------------------------          -----------------------------------------------------------------
  5690.  
  5691.  
  5692.           Introduction     These options are all related to image scaling.
  5693.                            Note that the -D option does not actually change
  5694.                            the size of the image, it specifies an aspect
  5695.                            ratio or image resolution to be placed in the
  5696.                            header of the output image.
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720.  
  5721.  
  5722.  
  5723.  
  5724.  
  5725.  
  5726.  
  5727.  
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.  
  5736.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-1
  5737.  
  5738.  
  5739.  
  5740.           Preserve Aspect Ratio                                          -+
  5741.  
  5742.  
  5743.           Purpose          Preserve aspect ratio when scaling.
  5744.  
  5745.           Syntax           -+ (plus)
  5746.  
  5747.           Comments         If specified with either the -X or -Y option
  5748.                            Alchemy will choose the other dimension to
  5749.                            preserve the aspect ratio of the image.
  5750.  
  5751.                            If specified in conjunction with both -X and -Y
  5752.                            Alchemy will use the values specified as a
  5753.                            bounding box, reducing one dimension if
  5754.                            necessary to preserve the image aspect ratio.
  5755.  
  5756.           Limitations      Does not pay attention to the pixel aspect ratio
  5757.                            values in the input image.
  5758.  
  5759.           Related options  -X   Scale image in horizontal dimension
  5760.                            -Y   Scale image in vertical dimension
  5761.  
  5762.           Examples         Change the size of the image toobig.gif so that
  5763.                            the width is 640 and the height is the correct
  5764.                            number to preserve the aspect ratio of the image
  5765.                            (the new image will be called notbig.gif):
  5766.  
  5767.                                 alchemy -X640 -+ toobig.gif -g notbig
  5768.  
  5769.                            Do the same thing but guarantee that the image
  5770.                            will not be larger than 640 by 480:
  5771.  
  5772.                                 alchemy -X640 -Y480 -+ toobig.gif -g notbig
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.                            Do the same thing but use better quality
  5779.                            scaling:
  5780.  
  5781.                                 alchemy -Xb640 -Yb480 -+ toobig.gif -g
  5782.                                 notbig
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-2
  5795.  
  5796.  
  5797.  
  5798.           Scale Image in Horizontal Direction                            -X
  5799.  
  5800.  
  5801.           Purpose          Scale the horizontal dimension of the image to
  5802.                            the specified number of pixels.
  5803.  
  5804.           Syntax           -X[scaleType] pixels
  5805.  
  5806.           Parameters       scaleType
  5807.                                 The type of scaling to use:
  5808.                                    a: nearest neighbor
  5809.                                    b: averaging/linear interpolation
  5810.                                    c: lanczos2
  5811.                                    d: lanczos3
  5812.                                 scaleType is optional; the default is
  5813.                            nearest neighbor.  The higher the scale type the
  5814.                            higher the quality (and the longer the
  5815.                            processing time).
  5816.  
  5817.                            pixels
  5818.                                 The number of pixels in the output image in
  5819.                            the horizontal dimension.
  5820.  
  5821.           Comments         Nearest neighbor type scaling is faster than the
  5822.                            other types but introduces aliasing (which
  5823.                            reduces image quality).  The highest quality
  5824.                            scaling supported is lanczos3, but it takes much
  5825.                            longer than averaging/linear interpolation and
  5826.                            generally doesn't produce significantly better
  5827.                            results.
  5828.  
  5829.           Limitations      All of the scale types other than nearest
  5830.                            neighbor give much better results than nearest
  5831.                            neighbor scaling, but they are slower and
  5832.                            require a new palette to be generated for
  5833.                            paletted output files (you can force alchemy to
  5834.                            use the original palette by using the -f option
  5835.                            and specifying the original image as the palette
  5836.                            file).
  5837.  
  5838.           Related options  -Y   Scale in vertical dimension
  5839.                            -+   Preserve aspect ratio
  5840.  
  5841.           Examples         Scale the input image, test.gif, to 640 by 480
  5842.                            using good quality scaling, calling the output
  5843.                            file test2.gif:
  5844.  
  5845.                                 alchemy test.gif -Xb640 -Yb480 -g test2.gif
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-3
  5853.  
  5854.  
  5855.  
  5856.                            Scale the input image, big.tga, using fast
  5857.                            scaling to an image which is 320 pixels across
  5858.                            and the same aspect ratio as the input image,
  5859.                            calling the output file out.tga:
  5860.  
  5861.                                 alchemy big.tga -X320 -+ -a out
  5862.  
  5863.                            Scale the input image, oddsize.gif, using the
  5864.                            highest quality scaling, to an image which is no
  5865.                            larger than 640x480, but has the same aspect
  5866.                            ratio as the original image, calling the output
  5867.                            image new.gif:
  5868.  
  5869.                                 alchemy oddsize.gif -Yd480 -Xd640 -+
  5870.                                 new.gif -g
  5871.  
  5872.                            Do the same thing as the previous example, but
  5873.                            retain the same palette:
  5874.  
  5875.                                 alchemy oddsize.gif -Yd480 -Xd640 -+
  5876.                                 new.gif -g -f oddsize.gif
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.  
  5892.  
  5893.  
  5894.  
  5895.  
  5896.  
  5897.  
  5898.  
  5899.  
  5900.  
  5901.  
  5902.  
  5903.  
  5904.  
  5905.  
  5906.  
  5907.  
  5908.  
  5909.  
  5910.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-4
  5911.  
  5912.  
  5913.  
  5914.           Scale Image in Vertical Direction                              -Y
  5915.  
  5916.  
  5917.           Purpose          Scale the vertical dimension of the image to the
  5918.                            specified number of pixels.
  5919.  
  5920.           Syntax           -Y[scaleType] pixels
  5921.  
  5922.           Parameters       ScaleType
  5923.                                 The type of scaling to use:
  5924.                                    a: nearest neighbor
  5925.                                    b: averaging/linear interpolation
  5926.                                    c: lanczos2
  5927.                                    d: lanczos3
  5928.                                 The default is nearest neighbor.
  5929.  
  5930.                            pixels
  5931.                                 The number of pixels in the vertical
  5932.                            dimension.
  5933.  
  5934.           Comments         Nearest neighbor type scaling is faster than the
  5935.                            other types but introduces aliasing.  The
  5936.                            highest quality scaling supported is lanczos3,
  5937.                            but it takes much longer than averaging/linear
  5938.                            interpolation and generally doesn't produce
  5939.                            significantly better results.
  5940.  
  5941.           Limitations      All of the scale types other than nearest
  5942.                            neighbor give much better results than nearest
  5943.                            neighbor scaling, but they are slower and
  5944.                            require a new palette to be generated for
  5945.                            paletted output files (you can force alchemy to
  5946.                            use the original palette by using the -f option
  5947.                            and specifying the original file name).
  5948.  
  5949.           Related options  -X   Scale in vertical dimension
  5950.                            -+   Preserve aspect ratio
  5951.  
  5952.           Examples         See the -X option, Scale Image in Horizontal
  5953.                            Direction, for examples.
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-5
  5969.  
  5970.  
  5971.  
  5972.           Specify Image Aspect Ratio                                     -D
  5973.  
  5974.  
  5975.           Purpose          Specify aspect ratio for the output image.
  5976.  
  5977.           Syntax           -D aspectRatio
  5978.  
  5979.           Parameter        aspectRatio
  5980.                                 The percentage of the width of a pixel to
  5981.                            its height.
  5982.  
  5983.           Comments         This option does not actually change the aspect
  5984.                            ratio of the image, it just adds the aspect
  5985.                            ratio value to the output file.  This is
  5986.                            important when trying to export the image to
  5987.                            software which expects this information.
  5988.  
  5989.                            The aspect ratio of an image is the ratio of the
  5990.                            width of a single pixel to the height of a
  5991.                            single pixel.  (So to specify an aspect ratio of
  5992.                            5:6 use -D 83, since (5/6)*100 is 83).
  5993.  
  5994.                            Alchemy attempts to preserve the aspect ratio
  5995.                            value when converting images whenever one is
  5996.                            found in the input image, but since so few file
  5997.                            formats have aspect ratio information this
  5998.                            hardly ever happens.
  5999.  
  6000.                            This option can also be used when displaying an
  6001.                            image on an IBM PC.
  6002.  
  6003.           Limitations      It is not possible to specify both an aspect
  6004.                            ratio and a dots per inch value for an image.
  6005.                            This is because specifying a dots per inch value
  6006.                            automatically implies an aspect ratio.
  6007.  
  6008.                            Many file types do not have an aspect ratio
  6009.                            value, so specifying one will have no effect.
  6010.  
  6011.           Related options  -D   Specify resolution
  6012.  
  6013.           Examples         You are converting a 640x350 IBM EGA PCX image
  6014.                            called ega.pcx (which has an aspect ratio of
  6015.                            35:48) to a TIFF image and you want the TIFF
  6016.                            image to have the correct aspect ratio value (so
  6017.                            that an intelligent TIFF reader will correctly
  6018.                            interpret the image) (Note that the value of 73
  6019.                            is (35/48)*100):
  6020.  
  6021.                                 alchemy ega.pcx -D 73 -t
  6022.  
  6023.  
  6024.  
  6025.  
  6026.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-6
  6027.  
  6028.  
  6029.  
  6030.                            The resulting image will still be 640x350, but
  6031.                            the TIFF file now contains the information that
  6032.                            the pixels are not square (and in fact are
  6033.                            35:48).
  6034.  
  6035.                            If you had instead wanted to convert the image
  6036.                            to a 640 by 480 image (with square pixels) you
  6037.                            could have used:
  6038.  
  6039.                                 alchemy ega.pcx -Y480 -D100 -t
  6040.  
  6041.                            The -D option isn't really needed here, since
  6042.                            any software reading the TIFF file will assume
  6043.                            that if there is no aspect ratio specified the
  6044.                            pixels are square.
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-7
  6085.  
  6086.  
  6087.  
  6088.           Specify Image Resolution                                       -D
  6089.  
  6090.  
  6091.           Purpose          Specify image resolution in dots per inch for
  6092.                            the output image.
  6093.  
  6094.           Syntax           -D dotsPerInchX dotsPerInchY
  6095.  
  6096.           Parameters       dotsPerInchX
  6097.                                 The resolution of the image in the X
  6098.                            direction in dots per inch.
  6099.  
  6100.                            dotsPerInchY
  6101.                                 The resolution of the image in the Y
  6102.                            direction in dots per inch.
  6103.  
  6104.           Comments         You must specify both dotsPerInchX and
  6105.                            dotsPerInchY, even if they are the same.
  6106.  
  6107.                            This command does not actually change the
  6108.                            resolution of the image, it just adds the
  6109.                            resolution fields to the output image.  This is
  6110.                            important when trying to import the image into
  6111.                            software which expects this information.  For
  6112.                            example, Microsoft Word is much more likely to
  6113.                            give the expected results when importing a TIFF
  6114.                            image for printing on a laser printer if the
  6115.                            image has a resolution of 300 dpi.
  6116.  
  6117.                            Reasonable values to use for dotsPerInch include
  6118.                            72 (the resolution of a 13 inch monitor
  6119.                            displaying 640x480) and 300 (the resolution of a
  6120.                            laser printer).
  6121.  
  6122.                            Alchemy will preserve this information when
  6123.                            converting files whenever possible.
  6124.  
  6125.  
  6126.  
  6127.           Limitations      It is not possible to specify both an aspect
  6128.                            ratio and a dots per inch value for an image.
  6129.                            This is because specifying a dots per inch value
  6130.                            automatically implies an aspect ratio.
  6131.  
  6132.                            This option is ignored when writing a file
  6133.                            format which does not have image resolution.
  6134.  
  6135.           Related options  -D   Specify aspect ratio
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-8
  6143.  
  6144.  
  6145.  
  6146.           Example          Convert the Targa file input.tga to a TIFF file
  6147.                            called output.tif, specifying that the
  6148.                            resolution of the image in the TIFF file is 300
  6149.                            dpi by 300 dpi:
  6150.  
  6151.                                 alchemy -t input.tga -D 300 300 output
  6152.  
  6153.                            Convert the file scan.tif to a DCX variation of
  6154.                            a PCX file, scaling the output image to 1500 by
  6155.                            750 (preserving the images aspect ratio) and
  6156.                            setting the resolution to 200dpi by 100dpi (this
  6157.                            is useful if you will be faxing the image using
  6158.                            a fax card):
  6159.  
  6160.                                 alchemy scan.tif -p1 -X1500 -Y750 -+
  6161.                                 -D 200 100
  6162.  
  6163.  
  6164.  
  6165.  
  6166.  
  6167.  
  6168.  
  6169.  
  6170.  
  6171.  
  6172.  
  6173.  
  6174.  
  6175.  
  6176.  
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.  
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.  
  6197.  
  6198.  
  6199.  
  6200.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     6-9
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.                                                                           7
  6207.  
  6208.  
  6209.  
  6210.           Viewing Options
  6211.  
  6212.  
  6213.           MS-DOS Only
  6214.           -----------------------------------------------------------------          -----------------------------------------------------------------
  6215.  
  6216.  
  6217.           Display hardware On properly equipped MS-DOS based computers
  6218.                            Image Alchemy can display images.
  6219.  
  6220.                            Depending on the hardware installed Alchemy
  6221.                            supports 320x200x256, 360x480x256, 640x400x256,
  6222.                            640x480x256, 800x600x256, 1024x768x256,
  6223.                            1280x1024x256, 640x480x32768, and 800x600x32768
  6224.                            display resolutions (the exact resolutions
  6225.                            supported depend on the model board installed).
  6226.  
  6227.                            Alchemy automatically detects which type of
  6228.                            display board you have installed.  If there are
  6229.                            multiple display boards installed in one
  6230.                            computer then Alchemy will display images on the
  6231.                            first board it finds,  searching in the
  6232.                            following order:
  6233.  
  6234.                               Western Digital based 8514/A board
  6235.  
  6236.                               AI compatible 8514/A board
  6237.  
  6238.                               VESA compatible SVGA board
  6239.  
  6240.                               Other SVGA board.
  6241.  
  6242.  
  6243.  
  6244.           Western Digital  8514/A boards which are equipped with the
  6245.                    8514/A  Western Digital chipset are automatically
  6246.                            recognized by Alchemy.  Depending on the model
  6247.                            board and the amount of memory installed,
  6248.                            640x480x256, 1024x768x256, and 1280x1024x256
  6249.                            modes are available.
  6250.  
  6251.  
  6252.  
  6253.  
  6254.  
  6255.  
  6256.  
  6257.  
  6258.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-1
  6259.  
  6260.  
  6261.  
  6262.                 AI 8514/A  Alchemy requires AI to be installed to use
  6263.                            8514/A displays which aren't based on the
  6264.                            Western Digital chipset.  In addition to 8514/A
  6265.                            boards Alchemy should also be able to display on
  6266.                            other AI compatible boards, such as 340x0 based
  6267.                            boards; however this has not been tested.  For
  6268.                            AI based boards the only resolution available is
  6269.                            1024x768x256
  6270.  
  6271.                      VESA  The best support for SVGA boards is available
  6272.                            for VESA compatible SVGA boards.  VESA is a SVGA
  6273.                            standard which allows applications software,
  6274.                            such as Image Alchemy, to interrogate the SVGA
  6275.                            board to determine which display modes are
  6276.                            available.  Some SVGA boards have VESA support
  6277.                            built directly into the BIOS found on the board;
  6278.                            in this case Alchemy will automatically detect
  6279.                            the VESA driver and use it.  Other SVGA boards
  6280.                            require a software driver to be installed;
  6281.                            these drivers are usually found on the floppy
  6282.                            disks which came with your SVGA board (typically
  6283.                            the driver is called VESA.EXE).  If you can't
  6284.                            find a driver on the diskettes and the
  6285.                            documentation does not explicitly mention that
  6286.                            VESA support is built into the BIOS you might
  6287.                            call the manufacturer to see if a VESA driver is
  6288.                            available.  VESA drivers are currently available
  6289.                            for VGA boards using chipsets from Cirrus Logic,
  6290.                            ATI Technologies, Chips and Technologies, Everex
  6291.                            Systems, Genoa Systems, Paradise Logic, Sigma
  6292.                            Designs, STB Systems, Tecmar, Headland
  6293.                            Technology (Video 7), Orchid Technology, Appian
  6294.                            Technology, Trident Microsystems, and Oak
  6295.                            Technology.
  6296.  
  6297.                Other SVGA  If Alchemy cannot find a VESA SVGA board it
  6298.                            attempts to determine what kind of SVGA board is
  6299.                            present.
  6300.  
  6301.                            The 320x200x256 mode is a standard IBM VGA mode
  6302.                            and will work on all VGA boards.  The
  6303.                            360x480x256 is a non-standard VGA mode which
  6304.                            should also work on all VGA boards.
  6305.  
  6306.                            Because of various incompatibilities between
  6307.                            different VGA boards 640x400x256 and/or
  6308.                            640x480x256 modes are not supported on some VGA
  6309.                            boards.  VGA boards which have been tested for
  6310.                            the higher resolution modes include Paradise,
  6311.                            Tseng Labs 3000 & 4000, Video 7, Trident, and
  6312.                            Everex chipset based VGA Boards.
  6313.  
  6314.  
  6315.  
  6316.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-2
  6317.  
  6318.  
  6319.  
  6320.           General          Unless you explicitly specify a resolution
  6321.                            Alchemy automatically uses the lowest resolution
  6322.                            mode which will display the entire picture.
  6323.  
  6324.                            The image will be positioned so that its center
  6325.                            coincides with that of the display.
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.  
  6346.  
  6347.  
  6348.  
  6349.  
  6350.  
  6351.  
  6352.  
  6353.  
  6354.  
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.  
  6367.  
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.  
  6374.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-3
  6375.  
  6376.  
  6377.  
  6378.           View Image                                                     -v
  6379.  
  6380.  
  6381.           Purpose          View file.
  6382.  
  6383.           Syntax           -v horizontalResolution
  6384.  
  6385.           Parameter        horizontalResolution
  6386.                                 320:Use 320x200 mode
  6387.                                 360:Use 360x480 mode
  6388.                                 640:Use 640x480 mode
  6389.                                 800:Use 800x600 mode
  6390.                                 1024:Use 1024x768 mode
  6391.                                 1280:Use 1280x1024 mode
  6392.  
  6393.           Comments         If displaying on a Western Digital chipset
  6394.                            8514/A or VESA compatible VGA, an optional
  6395.                            parameter may follow the -v command.  This
  6396.                            parameter specifies horizontal resolution and
  6397.                            may be 320, 360, 640, 800, 1024, or 1280.  The
  6398.                            default is to use the lowest resolution which
  6399.                            can fit the entire image.
  6400.  
  6401.                            If the image is true colour, a uniform palette
  6402.                            will be used and the image will be dithered
  6403.                            (dithering may be disabled by use of the -d
  6404.                            option, see above).  See Appendix B, Colour and
  6405.                            Dithering, for more information.
  6406.  
  6407.           Related options  -V   Reduce image to fit display
  6408.  
  6409.           Example          View the image madonna.gif:
  6410.  
  6411.                                 alchemy madonna.gif -v
  6412.  
  6413.  
  6414.  
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.  
  6425.  
  6426.  
  6427.  
  6428.  
  6429.  
  6430.  
  6431.  
  6432.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-4
  6433.  
  6434.  
  6435.  
  6436.           View Image in 15 Bit Mode                                     --v
  6437.  
  6438.  
  6439.           Purpose          View file using 15 bits/pixel mode.  This allows
  6440.                            true colour images to be viewed without
  6441.                            dithering to a uniform palette.
  6442.  
  6443.           Syntax           --v horizontalResolution
  6444.  
  6445.           Parameter        horizontalResolution
  6446.                                 640:Use 640x480 mode
  6447.                                 800:Use 800x600 mode
  6448.  
  6449.           Comments         Only works on a Tseng 4000 equipped SVGA board
  6450.                            with a Sierra DAC and 1 Megabyte of memory on
  6451.                            the SVGA board.
  6452.  
  6453.           Example          View madonna.tga:
  6454.  
  6455.                                 alchemy madonna.tga --v
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.  
  6466.  
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.  
  6475.  
  6476.  
  6477.  
  6478.  
  6479.  
  6480.  
  6481.  
  6482.  
  6483.  
  6484.  
  6485.  
  6486.  
  6487.  
  6488.  
  6489.  
  6490.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-5
  6491.  
  6492.  
  6493.  
  6494.           View Scaled Image                                              -V
  6495.  
  6496.  
  6497.           Purpose          View image while scaling image to fit on monitor
  6498.                            and correcting aspect ratio.
  6499.  
  6500.           Syntax           -V horizontalResolution
  6501.  
  6502.           Parameter        horizontalResolution
  6503.                                 320:Use 320x200 mode
  6504.                                 360:Use 360x480 mode
  6505.                                 640:Use 640x480 mode
  6506.                                 800:Use 800x600 mode
  6507.                                 1024:Use 1024x768 mode
  6508.                                 1280:Use 1280x1024 mode
  6509.  
  6510.           Comments         This command will scale the image and correct
  6511.                            the aspect ratio of the image by removing rows
  6512.                            and/or columns from the image.
  6513.  
  6514.                            Note that this option can also be useful for
  6515.                            displaying images which are not larger than the
  6516.                            screen but which have an aspect ratio different
  6517.                            than the display.
  6518.  
  6519.           Limitations      Alchemy assumes that the aspect ratio of a
  6520.                            display pixel is 1:1 when in 640x480, 800x600,
  6521.                            1024x768, and 1280x1024 modes, 5:6 when in
  6522.                            640x400 mode and 320x200 modes, and 16:9 in
  6523.                            360x480 mode.
  6524.  
  6525.                            If not otherwise specified by using the -D
  6526.                            option or in the file, Alchemy assumes that the
  6527.                            aspect ratio of pixels in 640x400 images and
  6528.                            320x200 images is 5:6 and the aspect ratio of
  6529.                            pixels in 640x350 images is 35:48.  You can
  6530.                            override any of these assumptions with the -D
  6531.                            option.
  6532.  
  6533.                            Don't worry if this is confusing;  in practice
  6534.                            Alchemy deals with everything automatically if
  6535.                            you use the -V option.  However, there is a
  6536.                            problem with displaying 320x400 IFF files; see
  6537.                            Appendix A, Answers to Frequently Asked
  6538.                            Questions, for more information.
  6539.  
  6540.           Related options  -D   Specify image resolution
  6541.                            -v   View image
  6542.  
  6543.           Example          View madonna.gif:
  6544.  
  6545.                                 alchemy madonna.gif -V
  6546.  
  6547.  
  6548.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     7-6
  6549.  
  6550.  
  6551.  
  6552.  
  6553.  
  6554.                                                                           A
  6555.  
  6556.  
  6557.  
  6558.           Answers to Frequently Asked Questions
  6559.           -----------------------------------------------------------------          -----------------------------------------------------------------
  6560.  
  6561.  
  6562.  
  6563.                   Question When I view a JPEG compressed image on my VGA
  6564.                            board it looks much worse than when I first
  6565.                            convert it to a GIF file and then view it.  Why
  6566.                            is this?
  6567.  
  6568.                     Answer To save time Alchemy automatically uses a
  6569.                            uniform palette when you are just viewing a true
  6570.                            colour image.  When converting to a different
  6571.                            file format Alchemy uses Heckbert quantization
  6572.                            to generate a palette.  The difference in image
  6573.                            quality is the difference between using a
  6574.                            uniform palette and an optimum palette.  See
  6575.                            Appendix B, Colour and Dithering, for more
  6576.                            information on palette generation.
  6577.  
  6578.  
  6579.                   Question Why can't my paint package read the Targa file I
  6580.                            wrote with Image Alchemy?
  6581.  
  6582.                     Answer Some software which reads Targa files can not
  6583.                            handle compressed files.  In addition, some
  6584.                            software can read true colour Targa files, but
  6585.                            can not read paletted or gray-scale files.
  6586.                            Image Alchemy can be forced to write out a true
  6587.                            colour file by using the -24 option.
  6588.  
  6589.  
  6590.                   Question I told Alchemy to convert a PCX file to an 8 bit
  6591.                            GIF file (using the -8 option).  Yet when I get
  6592.                            statistics on the file (using -x) Alchemy
  6593.                            reports the file only has 16 colours.
  6594.  
  6595.                     Answer Alchemy will always store the file using the
  6596.                            smallest bits-per-pixel allowable for the given
  6597.                            image (this results in the smallest possible
  6598.                            file).  In this case the input file only had 16
  6599.                            colours in it.
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.  
  6606.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-1
  6607.  
  6608.  
  6609.  
  6610.                            Things get more unpredictable with formats such
  6611.                            as Sun Raster (which requires 1 bit files to be
  6612.                            black and white) and SGI (which requires 8 bit
  6613.                            files to be gray-scale).  In these cases Alchemy
  6614.                            will always do the best it can (giving you a
  6615.                            warning message if it does something which may
  6616.                            surprise you later).
  6617.  
  6618.  
  6619.                   Question Why is decompressing or compressing a JPEG image
  6620.                            so slow?
  6621.  
  6622.                     Answer There are a large number of calculations that
  6623.                            have to be done during JPEG compression.  This
  6624.                            is an inherent limitation of JPEG compression.
  6625.                            Image Alchemy has been optimized quite a bit to
  6626.                            reduce the number of calculations, and we are
  6627.                            working to further reduce the number of
  6628.                            calculations.  If you are transferring files
  6629.                            over modems or storing them on slow media (tape)
  6630.                            the compression times are usually more than made
  6631.                            up for by the decrease in transmission or
  6632.                            retrieval times.
  6633.  
  6634.  
  6635.                   Question Why can't my favorite desktop publishing package
  6636.                            read the TIFF file I wrote with Image Alchemy?
  6637.  
  6638.                     Answer TIFF is an extremely versatile standard; it can
  6639.                            handle anything from 1 bit images to full colour
  6640.                            images with an alpha channel.  Also, TIFF allows
  6641.                            many different types of compression.
  6642.                            Unfortunately this versatility means that it's
  6643.                            difficult for a single piece of software to be
  6644.                            able to read in every valid TIFF file.
  6645.  
  6646.                            If the software specifies the classes of TIFF it
  6647.                            can read, you can force Alchemy to write out a
  6648.                            specific TIFF class by using the following
  6649.                            options:
  6650.                               class B: -8 -b -c2 -t2
  6651.                               class G: -8 -b -t1
  6652.                               class P: -8 -t1
  6653.                               class R: -24 -t1
  6654.  
  6655.                            Class B is black and white, Class G is gray-
  6656.                            scale, Class P is paletted, and Class R is true
  6657.                            colour.
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-2
  6665.  
  6666.  
  6667.  
  6668.                            If the supported classes are not specified
  6669.                            experiment with various combinations of -24, -8,
  6670.                            -b, and -c.  In this case it is usually best to
  6671.                            use no compression (-t0) while experimenting
  6672.                            with the other options, as many TIFF readers
  6673.                            have difficulty with compressed files.  When you
  6674.                            find a set of options that work, then you can
  6675.                            try various compression modes to save space.  Be
  6676.                            aware that using the -b option will force the
  6677.                            output file to be gray-scale and you will lose
  6678.                            the colour information in the file (most DTP
  6679.                            programs only have support for gray-scale TIFF
  6680.                            files).
  6681.  
  6682.                            You may also have to use the -Dn n option to
  6683.                            specify the resolution of the image (this is
  6684.                            especially true when converting from a file
  6685.                            format which does not have a value for image
  6686.                            resolution).  You can generally tell if this is
  6687.                            necessary because the program you are using to
  6688.                            read in the TIFF file will claim that the file
  6689.                            is unreasonably large or small.  Generally, if
  6690.                            you are using a 300 DPI Laser Printer you want
  6691.                            to make the TIFF file 300DPI x 300DPI (-
  6692.                            D 300 300).
  6693.  
  6694.                            If you would like further information specific
  6695.                            to using Image Alchemy with your word processor
  6696.                            or desktop publishing program please contact us;
  6697.                            we will be maintaining a list of how to make
  6698.                            Alchemy work with other software packages.
  6699.                            Similarly if you figure out how to import files
  6700.                            into a specific package let us know and we will
  6701.                            add your tips to our documentation.
  6702.  
  6703.  
  6704.  
  6705.  
  6706.  
  6707.  
  6708.  
  6709.  
  6710.  
  6711.  
  6712.  
  6713.  
  6714.  
  6715.  
  6716.  
  6717.  
  6718.  
  6719.  
  6720.  
  6721.  
  6722.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-3
  6723.  
  6724.  
  6725.  
  6726.                   Question I've converted a Mac PICT file to a GIF file,
  6727.                            but the GIF file is missing some or all of the
  6728.                            information that was in the PICT file.  What
  6729.                            happened to it?
  6730.  
  6731.                     Answer PICT files are a combination of drawing commands
  6732.                            (such as lines, rectangles, and circles) and
  6733.                            raster areas (called pixMaps).  Alchemy can only
  6734.                            read the raster portions of the files.  Programs
  6735.                            such as MacDraw and MacDraft write out files
  6736.                            with drawing commands, programs such as MacPaint
  6737.                            write out files which are entirely raster areas
  6738.                            (pixMaps), and some programs, such as SuperPaint
  6739.                            can write out files which are either or a
  6740.                            combination of both.  If you are using such a
  6741.                            program check the documentation on how to write
  6742.                            out files in "paint" mode.
  6743.  
  6744.  
  6745.                   Question When I convert a GIF file to a JPEG file and
  6746.                            then back to a GIF file the final GIF file is
  6747.                            twice the size of the original.  Why is this?
  6748.  
  6749.                     Answer There are two things which might cause this to
  6750.                            happen:
  6751.  
  6752.                            JPEG compression doesn't really work well for
  6753.                            images which have large areas which are all the
  6754.                            same colour.  The reason for this is that JPEG
  6755.                            is a lossy compression technique.  Therefore you
  6756.                            are not going to get back exactly the same
  6757.                            values for each pixel in an area that was one
  6758.                            solid colour before being JPEG compressed.  But
  6759.                            GIF compression works much better on areas which
  6760.                            are one solid colour, so, when you GIF compress
  6761.                            these areas, they are quite a bit larger than
  6762.                            they were before.  The solution to this problem
  6763.                            is to use HSI JPEG compression, which
  6764.                            automatically detects large areas of solid
  6765.                            colours and does not JPEG compress them.  The
  6766.                            problem with HSI JPEG compression is that it
  6767.                            isn't compatible with JPEG or JFIF.
  6768.  
  6769.  
  6770.  
  6771.  
  6772.  
  6773.  
  6774.  
  6775.  
  6776.  
  6777.  
  6778.  
  6779.  
  6780.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-4
  6781.  
  6782.  
  6783.  
  6784.                            The other possibility is that the input GIF file
  6785.                            didn't have very many different colours.  When
  6786.                            you converted it to a JPEG file the number of
  6787.                            colours in the file was lost (JPEG gray-scale
  6788.                            files always use 256 shades, and JPEG colour
  6789.                            files are always true colour).  When the JPEG
  6790.                            file was converted back to a GIF file Alchemy
  6791.                            assumed you wanted 256 colours in the file, and
  6792.                            a 256 colour GIF file is bigger than a 16 colour
  6793.                            GIF file.  To prevent this you can use a -c32
  6794.                            (or however many colours the original had)
  6795.                            option in the command line; this forces Image
  6796.                            Alchemy to use that many colours for the output
  6797.                            file.
  6798.  
  6799.  
  6800.                   Question I keep getting "Out of Memory trying to ..."
  6801.                            messages.  Help!
  6802.  
  6803.                     Answer Image Alchemy is running out of memory.  First
  6804.                            try to do the conversion again with the -$
  6805.                            (conserve memory) option.  Next, if that doesn't
  6806.                            help, attempt to maximize the amount of memory
  6807.                            available by removing as many memory resident
  6808.                            programs as you can.  If this still doesn't help
  6809.                            please contact us with the following
  6810.                            information: your computer configuration (amount
  6811.                            of available memory, size of hard disk),
  6812.                            operating system version, and what you are
  6813.                            trying to do (input file information (size of
  6814.                            image and type of file) and options specified).
  6815.                            Alchemy can generally convert images as larger
  6816.                            than 2000 pixels wide and a virtually unlimited
  6817.                            number of pixels tall.  However there are
  6818.                            certain conversions which require more memory
  6819.                            than others.
  6820.  
  6821.  
  6822.                   Question I am using Alchemy to display a 320x400 IFF
  6823.                            image created by an Amiga.  When I use just the
  6824.                            -v option the image comes out tall and skinny.
  6825.                            When I use the -V option, which is supposed to
  6826.                            correct the aspect ratio, things get worse
  6827.                            instead of better (the image is even skinnier).
  6828.                            What's going on?
  6829.  
  6830.                     Answer As near as we can tell, some Amiga software has
  6831.                            a different idea of what aspect ratio is than
  6832.                            the rest of the world.
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-5
  6839.  
  6840.  
  6841.  
  6842.                            For displays aspect ratio is defined as the
  6843.                            ratio of the width of a single pixel to the
  6844.                            height of a single pixel.  So if you have square
  6845.                            pixels (which you do on a standard monitor in
  6846.                            640x480 mode) the aspect ratio is 1 to 1
  6847.                            (commonly written as 1:1).  When you change
  6848.                            display modes the height and width of the total
  6849.                            display area does not change; what is changing
  6850.                            is the width and height of each pixel, which
  6851.                            means that the aspect ratio changes.  For
  6852.                            example, a 640x400 display has an aspect ratio
  6853.                            of 1:1.2 (that means each pixel is 1.2 times as
  6854.                            tall as it is wide (which makes sense since
  6855.                            480/400 equals 1.2)).  A 640x200 display
  6856.                            (remember IBM CGA graphics mode?) has an aspect
  6857.                            ratio of 1:2.4.
  6858.  
  6859.                            Now this is where it gets interesting in terms
  6860.                            of IFF files.  The aspect ratio number stored in
  6861.                            Amiga IFF files for 320x400 images is 1:1.1,
  6862.                            meaning pixels are 1.1 times as tall as they are
  6863.                            wide, so therefore the actual image should be
  6864.                            the equivalent size of a 320x440 image with
  6865.                            square pixels.  And this is what Alchemy will
  6866.                            attempt to display when you use the -V option
  6867.                            (Alchemy never makes any dimension larger, so
  6868.                            the actual image Alchemy displays is 291x400,
  6869.                            which is the same ratio as 320x440).  However
  6870.                            this is obviously wrong, as you can tell when
  6871.                            you examine an image.  As near as we can tell
  6872.                            the correct aspect ratio of these images is 5:3
  6873.                            (the math we used to come up with this number is
  6874.                            640/320:480/400).  And if you tell Alchemy to
  6875.                            override the aspect ratio by using a -D 167
  6876.                            option (167 because 5/3*100 is 166.6666) the
  6877.                            image displays correctly.  Why Amigas create
  6878.                            images which claim they are 1:1.1 remains a
  6879.                            mystery.
  6880.  
  6881.  
  6882.  
  6883.  
  6884.  
  6885.  
  6886.  
  6887.  
  6888.  
  6889.  
  6890.  
  6891.  
  6892.  
  6893.  
  6894.  
  6895.  
  6896.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-6
  6897.  
  6898.  
  6899.  
  6900.                   Question When I convert a 32 bit Targa file to a GIF file
  6901.                            and then to a JPEG file it doesn't look nearly
  6902.                            as good as if I convert the Targa File directly
  6903.                            to the JPEG file.  What can I do to maintain
  6904.                            high quality in JPEG compressed files?
  6905.  
  6906.                     Answer When the Targa file was converted to the GIF
  6907.                            file Image Alchemy had to reduce the number of
  6908.                            colours in the file (the original Targa File had
  6909.                            up to 16 million colours, GIF files are limited
  6910.                            to 256 colours).  This step is known as colour
  6911.                            quantization (Image Alchemy uses the Heckbert
  6912.                            Median Cut method for quantization, see Appendix
  6913.                            B, Colour and Dithering, for more information).
  6914.                            The difficulty with colour quantization is that
  6915.                            it leaves artifacts known as colour banding.  To
  6916.                            reduce this phenomenon Image Alchemy dithers the
  6917.                            image (you can see the effect of colour banding
  6918.                            by turning off dithering by using the -d0
  6919.                            option).  Unfortunately a dithered image does
  6920.                            not JPEG compress very well (dithering adds a
  6921.                            lot of high-frequency information to an image;
  6922.                            JPEG compression attempts to remove much of that
  6923.                            information).  In addition JPEG images are
  6924.                            always continuous colour images, so when the
  6925.                            JPEG file is decompressed it has to be colour
  6926.                            quantized and dithered again.  Dithering a
  6927.                            previously dithered image reduces the quality
  6928.                            even more.  The solution is to use the best
  6929.                            starting quality you can for JPEG compression,
  6930.                            ideally a continuous tone image.  The compressed
  6931.                            image size will be smaller than if you had
  6932.                            started with a paletted image and the quality
  6933.                            will be better.
  6934.  
  6935.  
  6936.                   Question I've converted an HP PCL file to a GIF file, but
  6937.                            the GIF file is missing some or all of the
  6938.                            information that was in the PCL file.  What
  6939.                            happened to it?
  6940.  
  6941.                     Answer PCL files have the same problem as PICT files
  6942.                            (see above); they are a combination of drawing
  6943.                            commands (such as lines and rectangles) and
  6944.                            raster areas (called rasters) and Alchemy can
  6945.                            only convert the raster areas in PCL files.  PCL
  6946.                            Files also contain font and text information,
  6947.                            which is also lost.  Unfortunately there isn't
  6948.                            any general way to preserve this data with
  6949.                            Alchemy.
  6950.  
  6951.  
  6952.  
  6953.  
  6954.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-7
  6955.  
  6956.  
  6957.  
  6958.                            One thing which you can do if running Microsoft
  6959.                            Windows 3.0 is to install Adobe Type Manager
  6960.                            (ATM).  ATM automatically intercepts any text
  6961.                            commands and converts them to rasters.  In
  6962.                            addition, the standard Windows 3.0 HP PCL driver
  6963.                            only generates rasters, not vectors.  So the
  6964.                            file will appear in its entirety when converted
  6965.                            by Alchemy.  Contact us if you want further
  6966.                            information on using Alchemy with Windows 3.0.
  6967.  
  6968.  
  6969.                   Question Why can't Image Alchemy read in JPEG files
  6970.                            produced by Kodak's ColorSqueeze (or Sun's
  6971.                            VFCtool)?
  6972.  
  6973.                     Answer The JPEG standard is still in draft form.  Until
  6974.                            it is a mature standard, various manufacturer's
  6975.                            will implement different versions of it.  As of
  6976.                            March 1, 1991 Image Alchemy supports the JFIF
  6977.                            format and should work with any other JPEG
  6978.                            software which also claims JFIF compatibility.
  6979.                            If other software you are using claims to
  6980.                            support the JFIF format and you are having
  6981.                            trouble please contact us.  If the other
  6982.                            software does not support JFIF, contact the
  6983.                            manufacturer and tell them they should send you
  6984.                            an update which does (you can tell them to
  6985.                            contact us if they need a copy of the JFIF
  6986.                            standard).
  6987.  
  6988.  
  6989.                   Question I converted a PCX file with 16 colours to a 16
  6990.                            shades of gray TIFF file using the -b and -t
  6991.                            options.  The 16 colour PCX file had some shades
  6992.                            of gray in it which were changed in the TIFF
  6993.                            file.  How can I prevent this?
  6994.  
  6995.                     Answer The problem is that gray-scale TIFF files have a
  6996.                            uniformly spaced gray palette.  If you create a
  6997.                            TIFF file with 16 shades of gray it will have
  6998.                            the following shades in it: 0, 17, 34, 51, 68,
  6999.                            85, 102, 119, 136, 153, 170, 187, 204, 221, 238,
  7000.                            and 255.  However the 16 colour PCX file you
  7001.                            started with probably didn't have those exact
  7002.                            colours in it (for example, PCX files written
  7003.                            out by Windows 3.0 Paint have shades of gray
  7004.                            which correspond to 0, 128, 192, and 255).  So
  7005.                            Alchemy did the best it could and matched the
  7006.                            input colours to the output colours (and
  7007.                            depending on the other options that you
  7008.                            specified may also have dithered the image).
  7009.  
  7010.  
  7011.  
  7012.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-8
  7013.  
  7014.  
  7015.  
  7016.                            The solution is to tell Alchemy to write out a
  7017.                            256 colour gray-scale TIFF file (which you do by
  7018.                            adding a -c256 to the -b and -t options).  This
  7019.                            file still has a uniform gray palette; but that
  7020.                            palette now contains every colour:  0, 1, 2, 3,
  7021.                            ..., 255.  Therefore Alchemy can map, for
  7022.                            example, the colours 128 and 192 to their exact
  7023.                            match.  This does have the disadvantage of
  7024.                            making the resulting 256 colour TIFF file twice
  7025.                            as large as the 16 colour TIFF file, but this is
  7026.                            the only way to guarantee that Alchemy can find
  7027.                            an exact match for all the shades of gray in the
  7028.                            input file.
  7029.  
  7030.  
  7031.                   Question Why do you only allow specifying image
  7032.                            resolution in Dots Per Inch?  Don't you realize
  7033.                            that most of the world is metric?
  7034.  
  7035.                     Answer Yes, we do realize that the entire world, with
  7036.                            the exception of the United States and Great
  7037.                            Britain, claims to use the metric system
  7038.                            exclusively (and Great Britain will presumably
  7039.                            change in 1992).  However, this isn't actually
  7040.                            true.  A laser printer manufactured in Japan is
  7041.                            still 300 dots per inch (not 11.811... dots per
  7042.                            mm) and a 19 inch monitor sold in Europe is
  7043.                            called a 19 inch monitor (actually a 19 inch
  7044.                            monitor is called a 20 inch monitor in Europe,
  7045.                            which is a measure of the total picture tube
  7046.                            diagonal, not just the viewing area).
  7047.  
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.  
  7054.  
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.  
  7067.  
  7068.  
  7069.  
  7070.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     A-9
  7071.  
  7072.  
  7073.  
  7074.  
  7075.  
  7076.                                                                           B
  7077.  
  7078.  
  7079.  
  7080.           Colour and Dithering
  7081.           -----------------------------------------------------------------          -----------------------------------------------------------------
  7082.  
  7083.  
  7084.           Paletted vs.     Colour images are normally stored in one of two
  7085.           true colour      ways: as an array of direct colour values
  7086.                            (usually red, green, and blue) (referred to as a
  7087.                            true colour file in this document) or as an
  7088.                            array of indices into a colour-map which
  7089.                            contains red, green, and blue colour values
  7090.                            (referred to as a paletted file in this
  7091.                            document).
  7092.  
  7093.                            The reason for the existence of paletted images
  7094.                            is that they take less memory, so the hardware
  7095.                            to display them is less expensive.  The
  7096.                            dominance of paletted hardware is changing as
  7097.                            the price of memory and the processing power it
  7098.                            takes to update large amounts of memory at a
  7099.                            reasonable speed drops (a Targa 32 board is an
  7100.                            example of a true colour board, a VGA board is
  7101.                            an example of a paletted board).
  7102.  
  7103.                            Until true colour graphics devices become the
  7104.                            norm there's a need to convert images from true
  7105.                            colour to paletted.  This conversion is done in
  7106.                            two steps: the first is to generate a palette
  7107.                            for use by the image;  the second is to map the
  7108.                            image to the new palette.
  7109.  
  7110.           Colour cube      The colour model generally used by computers is
  7111.                            a cube with red, green, and blue as the axes
  7112.                            (this is known as a colour cube or RGB cube).
  7113.                            Each point inside the cube is a different
  7114.                            colour, depending on the amount of red, green,
  7115.                            and blue used.  In nature each of the three axes
  7116.                            is nearly continuous, therefore there are a
  7117.                            nearly infinite number of colours available.
  7118.                            Computer hardware and software represent colours
  7119.                            in a discrete fashion.
  7120.  
  7121.  
  7122.  
  7123.  
  7124.  
  7125.  
  7126.  
  7127.  
  7128.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     B-1
  7129.  
  7130.  
  7131.  
  7132.                            For true colour displays or file formats the
  7133.                            number of discrete positions along each axis of
  7134.                            the colour cube gives the colour resolution of
  7135.                            the output device.  For example, a Targa 24
  7136.                            board for an IBM PC has 8 bits per red, green,
  7137.                            and blue channel for a total of 24 bits (or 256
  7138.                            discrete shades of each colour, for a total of
  7139.                            16 million colours (256x256x256)).  This is also
  7140.                            the colour resolution of most true colour file
  7141.                            formats.
  7142.  
  7143.                            The new 15 bit SVGA boards have 5 bits per
  7144.                            channel, for a total of 32x32x32 different
  7145.                            colours (32,768).  This is the same colour
  7146.                            resolution as a Targa 15 file.
  7147.  
  7148.                            A paletted display or image file has the same
  7149.                            colour resolution limit as a true colour display
  7150.                            or image file, but in addition there is a limit
  7151.                            on how many points inside the cube can be used
  7152.                            at the same time.  An 8 bit file format, such as
  7153.                            GIF, allows 256 different colours out of 16
  7154.                            million.  A normal SVGA board also only allows
  7155.                            256 different colours at one time.
  7156.  
  7157.                            So, converting a true colour file to a paletted
  7158.                            file involves reducing the number of occupied
  7159.                            points in the colour cube.  There are several
  7160.                            ways this can be done.
  7161.  
  7162.  
  7163.           Generating a     Image Alchemy supports two methods of generating
  7164.           palette          a palette:
  7165.  
  7166.                   Uniform  The simplest and fastest method is to use a
  7167.                  palettes  palette containing colours which are uniformly
  7168.                            distributed in the RGB cube, referred to as a
  7169.                            uniform palette.  This has the advantage that
  7170.                            it's fast and the same palette can be used for
  7171.                            any image; the primary disadvantage is that most
  7172.                            images don't contain colours from everywhere in
  7173.                            the RGB cube, so palette entries are wasted
  7174.                            representing colours that aren't needed for the
  7175.                            particular image being converted.
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.  
  7184.  
  7185.  
  7186.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     B-2
  7187.  
  7188.  
  7189.  
  7190.                   Optimal  To generate a palette which is better for
  7191.                  palettes  representing a particular image, Image Alchemy
  7192.                            supports Heckbert's median cut algorithm.  This
  7193.                            algorithm first builds a three dimensional table
  7194.                            (a histogram cube) indicating how popular any
  7195.                            given colour in the RGB cube is in the image
  7196.                            being converted.  It then proceeds to subdivide
  7197.                            this histogram cube (by dividing boxes in half)
  7198.                            until it has created as many boxes as there are
  7199.                            palette entries.  The decision as to where to
  7200.                            divide a box is based on the distribution of
  7201.                            colours within the box.  This algorithm attempts
  7202.                            to create boxes which have approximately equal
  7203.                            popularity in the image.
  7204.  
  7205.                            Palette entries are then assigned to represent
  7206.                            each box.  There are other methods of generating
  7207.                            a palette from an image, but Heckbert's
  7208.                            algorithm is generally regarded as the best
  7209.                            tradeoff between speed and quality.
  7210.  
  7211.  
  7212.             Modifying the  You can change the method used to select a
  7213.                   palette  colour to represent each box by use of the -z
  7214.                 selection  options.
  7215.                   process
  7216.                            The default method is to use the mean of all the
  7217.                            colours in the box.  However for some images
  7218.                            slightly better results can be obtained by using
  7219.                            the center of the box (without regard to where
  7220.                            the pixels are in the box).
  7221.  
  7222.                            For images being reduced to a very small number
  7223.                            of colours (less than 16) better results can be
  7224.                            obtained by using a corner of the box (the boxes
  7225.                            tend to be large when reducing an image to a
  7226.                            small number of colours; therefore picking
  7227.                            colours near the centers of the boxes will give
  7228.                            you muddy colours, while using corners of the
  7229.                            boxes will give you more saturated colours).
  7230.  
  7231.  
  7232.  
  7233.           Mapping the      The next step is to map the image to the new
  7234.           image to the     palette; this is where dithering becomes
  7235.           palette          important.
  7236.  
  7237.  
  7238.  
  7239.  
  7240.  
  7241.  
  7242.  
  7243.  
  7244.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     B-3
  7245.  
  7246.  
  7247.  
  7248.              No dithering  The simplest approach is to map every colour in
  7249.                            the original image to the palette entry which is
  7250.                            closest to it (this is what Image Alchemy does
  7251.                            if you specify no dithering).
  7252.  
  7253.                            However, since the palette entries generally
  7254.                            represent several different colours in the
  7255.                            original image, this results in colour banding
  7256.                            where areas of smooth colour changes in the
  7257.                            original become areas of one solid colour in the
  7258.                            paletted version.
  7259.  
  7260.             Advantages of  This can be alleviated by dithering the image
  7261.                 dithering  data such that any given pixel might not be
  7262.                            mapped to its closest palette entry, but the
  7263.                            average over some area of the image will be
  7264.                            closer to the correct colour than it would
  7265.                            otherwise be.  Image Alchemy uses a class of
  7266.                            algorithms called "error-diffusion" to do
  7267.                            dithering.
  7268.  
  7269.           Error diffusion  These algorithms work by using the closest
  7270.                 dithering  palette entry to a colour and then distributing
  7271.                            the error (the difference between the desired
  7272.                            colour and the chosen palette entry) to the
  7273.                            nearby pixels.  This process is repeated for
  7274.                            every pixel in the image, using the colour
  7275.                            values which have been modified due to the error
  7276.                            from previous pixels.  The different dithering
  7277.                            algorithms spread the error over a different
  7278.                            area or use a different weighting within the
  7279.                            same area.
  7280.  
  7281.                Serpentine  Error diffusion can be done as a normal raster
  7282.                    raster  (left to right, top to bottom) or as a
  7283.                            serpentine raster (alternating left to right and
  7284.                            right to left, top to bottom).  A serpentine
  7285.                            raster tends to break up visible patterns
  7286.                            introduced by dithering.
  7287.  
  7288.                     Noise  Random noise can also be added to help break up
  7289.                            visible patterns in the resulting image.
  7290.  
  7291.  
  7292.           Further          For more information on Heckbert's median cut
  7293.           information      and dithering see the appropriate reference
  7294.                            listed in the References section below.
  7295.  
  7296.  
  7297.  
  7298.  
  7299.  
  7300.  
  7301.  
  7302.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     B-4
  7303.  
  7304.  
  7305.  
  7306.  
  7307.  
  7308.                                                                           C
  7309.  
  7310.  
  7311.  
  7312.           What is JPEG Compression?
  7313.           -----------------------------------------------------------------          -----------------------------------------------------------------
  7314.  
  7315.  
  7316.           Who are those    JPEG stands for the "Joint Photographic Experts
  7317.           JPEG guys?       Group".  This is a group of experts who defined
  7318.                            a standard compression scheme for still images,
  7319.                            commonly called JPEG Compression.  Currently the
  7320.                            standard is still in draft form.  The standard
  7321.                            should be finalized in 1991.
  7322.  
  7323.           Overview         JPEG Compression consists of a series of
  7324.                            reasonably complex mathematical operations.
  7325.                            These include: colour space conversion, discrete
  7326.                            cosine transforms, quantization, and entropy
  7327.                            coding.  After these steps you end up with an
  7328.                            image which takes fewer bits to store than you
  7329.                            started out with.
  7330.  
  7331.                            However, when you decompress a JPEG compressed
  7332.                            image you end up with an image that is not quite
  7333.                            the same as the original  (which is why JPEG
  7334.                            Compression is referred to as "lossy").
  7335.  
  7336.           Is lossy         You might well ask why anyone would want to
  7337.           compression bad? compress an image using a lossy technique.
  7338.                            Compression ratios for lossy compression are
  7339.                            much better than for lossless compression and
  7340.                            the loss is generally very small.  And, in fact,
  7341.                            every operation of converting an image is lossy
  7342.                            (the original photographic or electronic process
  7343.                            which captured the image was lossy, scanning or
  7344.                            digitizing the image was lossy, displaying the
  7345.                            image on a monitor is lossy, and printing the
  7346.                            image is lossy).
  7347.  
  7348.  
  7349.           Details          JPEG compression involves the following steps:
  7350.  
  7351.  
  7352.  
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.  
  7360.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     C-1
  7361.  
  7362.  
  7363.  
  7364.                    Step 1  The image is converted to a colour space with
  7365.                            separate luminance and chrominance channels.
  7366.                            This is done because the human eye is far more
  7367.                            sensitive to the luminance information (Y) than
  7368.                            it is to the chrominance information (Cb and
  7369.                            Cr); by separating them, it's possible to
  7370.                            compress the chrominance information more than
  7371.                            the luminance before the perceived image quality
  7372.                            suffers.
  7373.  
  7374.                            This step isn't specified in the JPEG draft (it
  7375.                            doesn't discuss colour space at all), but is
  7376.                            standard practice.  Image Alchemy uses CCIR-601
  7377.                            YCbCr, which is the colour space specified by
  7378.                            the JFIF standard.
  7379.  
  7380.                    Step 2  The luminance and chrominance information are
  7381.                            separately transformed to the frequency domain
  7382.                            using a discrete cosine transform acting on 8x8
  7383.                            pixel blocks.
  7384.  
  7385.                            To reduce the amount of data which needs to be
  7386.                            compressed the chrominance information may be
  7387.                            sub-sampled first.  Alchemy uses
  7388.                            2h:1v:1h:1v:1h:1v sub-sampling when writing JPEG
  7389.                            files, which means that the first component
  7390.                            (luminance) has twice as many samples
  7391.                            horizontally as the other two components
  7392.                            (chrominance), and the same number of samples
  7393.                            vertically.  Alchemy can read JPEG files with
  7394.                            any sub-sampling allowed by the draft standard.
  7395.  
  7396.                    Step 3  The transformed data is quantized (so some
  7397.                            information is thrown away).  The samples
  7398.                            representing higher frequencies are generally
  7399.                            quantized using larger steps than those
  7400.                            representing low frequencies.
  7401.  
  7402.                            The quality level you specify is used to scale a
  7403.                            set of quantization values which have been found
  7404.                            to cause the quantized data to all have
  7405.                            approximately equal importance visually.  A
  7406.                            lower quality number will cause larger
  7407.                            quantization steps to be used, and hence
  7408.                            increase the compression ratio and decrease the
  7409.                            image quality.
  7410.  
  7411.  
  7412.  
  7413.  
  7414.  
  7415.  
  7416.  
  7417.  
  7418.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     C-2
  7419.  
  7420.  
  7421.  
  7422.                    Step 4  The quantized data is compressed using an
  7423.                            entropy coder.  Huffman and Arithmetic coding
  7424.                            are allowed by the draft JPEG standard; only
  7425.                            Huffman coding is allowed by the JFIF standard.
  7426.                            Huffman coding can either be done with a set of
  7427.                            fixed tables or custom tables can be generated
  7428.                            for an image.  Alchemy, by default, uses a fixed
  7429.                            set of tables, but can also generate custom
  7430.                            tables which usually produce 5-20% (depending on
  7431.                            the image and quality setting) better
  7432.                            compression.  However, producing custom tables
  7433.                            requires an additional pass over the image data
  7434.                            and therefore takes a little longer.
  7435.  
  7436.  
  7437.           JPEG Interchange This data corresponds to the JPEG Interchange
  7438.           Format           Format and is ready to be stored in a file.
  7439.                            Unfortunately the JPEG Interchange Format does
  7440.                            not include enough information to actually be
  7441.                            able to convert the file back to an image.
  7442.                            Specifically the colour space used and the
  7443.                            aspect ratio or resolution of the image are not
  7444.                            included.  Until recently there was no standard
  7445.                            way of putting this information in a JPEG file.
  7446.  
  7447.           JFIF             On March 1, 1991 representatives of several JPEG
  7448.                            hardware and software developers (including C-
  7449.                            Cube, Radius, NeXT, Storm Tech., the PD JPEG
  7450.                            group, Sun, and Handmade Software) met at C-Cube
  7451.                            and established the JPEG File Interchange Format
  7452.                            (JFIF).  If you would like more information on
  7453.                            the JFIF standard please contact us.
  7454.  
  7455.  
  7456.  
  7457.  
  7458.  
  7459.  
  7460.  
  7461.  
  7462.  
  7463.  
  7464.  
  7465.  
  7466.  
  7467.  
  7468.  
  7469.  
  7470.  
  7471.  
  7472.  
  7473.  
  7474.  
  7475.  
  7476.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     C-3
  7477.  
  7478.  
  7479.  
  7480.  
  7481.  
  7482.                                                                           D
  7483.  
  7484.  
  7485.  
  7486.           Customer Support
  7487.           -----------------------------------------------------------------          -----------------------------------------------------------------
  7488.  
  7489.  
  7490.           Why might        We have made every effort to insure that Image
  7491.           Alchemy mess up? Alchemy can read all files in its supported
  7492.                            formats.  However, because of poorly written
  7493.                            standards and non-adherence to standards there
  7494.                            are undoubtedly certain files that Image Alchemy
  7495.                            does not read correctly.
  7496.  
  7497.           What we need to  If you come across any files which Image Alchemy
  7498.           fix the problem  has trouble with please contact us with as much
  7499.                            of the following information as you have:
  7500.                            version of Image Alchemy you are using, type of
  7501.                            file, type of computer which generated it, name
  7502.                            and version of software which wrote the file,
  7503.                            size of image, and the number of colours in
  7504.                            image.  We may ask you to send us the file so
  7505.                            that we can figure out what went wrong.  If you
  7506.                            send us a file we will attempt to modify Image
  7507.                            Alchemy so that it can read the file.  And if by
  7508.                            some miracle we manage to get it to work, we
  7509.                            will send you an updated copy of Image Alchemy.
  7510.  
  7511.                            Similarly, if any files that Image Alchemy
  7512.                            writes can not be read by other software we want
  7513.                            to know that also.  Since we do not own a copy
  7514.                            of every software package we may ask you to send
  7515.                            us a copy of a file that can be read by that
  7516.                            package; we will then compare that to a file
  7517.                            written out by Image Alchemy to determine what
  7518.                            the differences are.
  7519.  
  7520.  
  7521.                            Please contact us even if you are just using a
  7522.                            demo copy of Alchemy.  In addition to helping
  7523.                            fix a potential bug, we feel the best way to get
  7524.                            you to purchase a copy of Alchemy is to
  7525.                            demonstrate how committed we are to customer
  7526.                            support.
  7527.  
  7528.  
  7529.  
  7530.  
  7531.  
  7532.  
  7533.  
  7534.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     D-1
  7535.  
  7536.  
  7537.  
  7538.           How to contact   The best way to contact us is by e-mail; this is
  7539.           us               especially true if you can send us a sample file
  7540.                            which demonstrates the problem.  Our e-mail
  7541.                            addresses are:
  7542.  
  7543.                               Internet:  hsi@netcom.COM
  7544.                               CompuServe:  71330, 3136
  7545.  
  7546.                            We also have a 24 hour bulletin board where you
  7547.                            can upload and download files.  It speaks 2400
  7548.                            baud, 9600 baud (v32, v42, and v42.bis), and PEP
  7549.                            and its number is:
  7550.  
  7551.                               +1 408 356-3297 (BBS)
  7552.  
  7553.                            If you want to contact us through more
  7554.                            pedestrian means our address and phone numbers
  7555.                            are:
  7556.  
  7557.                               Handmade Software, Inc.
  7558.                               15951 Los Gatos Blvd., Suite 17
  7559.                               Los Gatos, CA  95032
  7560.                               
  7561.                               +1 408 358-1292 (Voice)
  7562.                               +1 408 356-4143 (Fax)
  7563.  
  7564.  
  7565.  
  7566.  
  7567.  
  7568.  
  7569.  
  7570.  
  7571.  
  7572.  
  7573.  
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581.  
  7582.  
  7583.  
  7584.  
  7585.  
  7586.  
  7587.  
  7588.  
  7589.  
  7590.  
  7591.  
  7592.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     D-2
  7593.  
  7594.  
  7595.  
  7596.  
  7597.  
  7598.                                                                           E
  7599.  
  7600.  
  7601.  
  7602.           Binary Information Files (BIF)
  7603.           -----------------------------------------------------------------          -----------------------------------------------------------------
  7604.  
  7605.  
  7606.           Overview         Binary files are image files which are just
  7607.                            data.  In other words, they do not contain any
  7608.                            information other than the actual pixels in the
  7609.                            image.  In order to read these files you must
  7610.                            create a file using a text editor which
  7611.                            describes to Alchemy the format of the file you
  7612.                            are trying to read in.  This is called a BIF
  7613.                            file (and normally has the extension .bif).
  7614.  
  7615.           Required         At the minimum a BIF file needs to contain the
  7616.           information      filename of the image file and either the height
  7617.                            or the width of the image.  Alchemy will make
  7618.                            assumptions about the other characteristics of
  7619.                            the image based on the information that it is
  7620.                            given and the total length of the image file.
  7621.  
  7622.  
  7623.           BIF file format  The first line contains the letters BIF, which
  7624.                            identifies the file as a BIF file.
  7625.  
  7626.                            Each of the rest of the lines in the BIF file
  7627.                            consist of an information tag followed by the
  7628.                            information.  The spelling of the tags must be
  7629.                            exact or Alchemy will report an unknown tag
  7630.                            error.
  7631.  
  7632.  
  7633.  
  7634.  
  7635.  
  7636.  
  7637.  
  7638.  
  7639.  
  7640.  
  7641.  
  7642.  
  7643.  
  7644.  
  7645.  
  7646.  
  7647.  
  7648.  
  7649.  
  7650.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     E-1
  7651.  
  7652.  
  7653.  
  7654.           Tags
  7655.  
  7656.                       Tag  Description
  7657.  
  7658.                  filename  The name of the file containing the binary data.
  7659.  
  7660.                     width  The width of the image data, in pixels.
  7661.  
  7662.                    height  The height of the image data, in pixels.
  7663.  
  7664.                    planes  The number of planes of image data (1, 2, 3, or
  7665.                            4).
  7666.                            A 1 plane image is assumed to be gray-scale, a 2
  7667.                            plane image is a gray-scale image with an alpha
  7668.                            channel, a 3 plane image is a RGB image, and a 4
  7669.                            plane image is a RGB image with an alpha
  7670.                            channel.
  7671.  
  7672.                    header  The size of the header, in bytes.  This many
  7673.                            bytes will be skipped when reading the file.
  7674.  
  7675.               leftpadding  The number of bytes to remove from the beginning
  7676.                            of each scan line.
  7677.  
  7678.              rightpadding  The number of bytes to remove from the end of
  7679.                            each scan line.
  7680.  
  7681.                     order  The order of the pixels.
  7682.                            For 3 channel images, this can be any sequence
  7683.                            of r, g, and b: rgb, rbg, grb, gbr, brg, or bgr
  7684.                            (r=red, g=green, b=blue).
  7685.                            For 4 channel images, this can be any sequence
  7686.                            of a, r, g, and b (a=alpha).
  7687.                            Either ga or ag for 2 channel images (g=gray,
  7688.                            a=alpha).
  7689.  
  7690.                            The defaults are g, ga, rgb, and rgba, depending
  7691.                            on the number of planes.
  7692.  
  7693.                upsidedown  The presence of this tag indicates that the data
  7694.                            in the file is recorded from the bottom of the
  7695.                            screen up to the top of the screen.
  7696.  
  7697.  
  7698.  
  7699.           Comments         Lines beginning with a # are treated as
  7700.                            comments.  Comments and blank lines are ignored
  7701.                            when processing the file.
  7702.  
  7703.  
  7704.  
  7705.  
  7706.  
  7707.  
  7708.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     E-2
  7709.  
  7710.  
  7711.  
  7712.           Palette files    If the binary file has a palette available, you
  7713.                            can use that palette by writing custom software
  7714.                            to convert it to a .PAL file and using the -F
  7715.                            option while reading the BIF file.
  7716.  
  7717.           Example          This is an example BIF file which can be used to
  7718.                            read a 640 pixel wide, true colour HSI Raw file.
  7719.                            Note that HSI raw files have a 32 byte header
  7720.                            which is being skipped.  Of course you could
  7721.                            read the Raw file directly using Alchemy, but
  7722.                            this is after all an example of a BIF file.
  7723.  
  7724.                                 BIF
  7725.                                 width    640
  7726.                                 #skip past header
  7727.                                 header    32
  7728.  
  7729.                                 filename  sample.raw
  7730.                                 planes     3
  7731.  
  7732.                                 #the tag below isn't actually needed,
  7733.                                 #since rgb is the default, but is
  7734.                                 #included here to give an example of
  7735.                                 #what an order tag looks like
  7736.  
  7737.                                 order   rgb
  7738.  
  7739.           Using the        Assuming the BIF file is called sample.bif, the
  7740.           example BIF file following Alchemy command can be used to convert
  7741.                            the image to a GIF file:
  7742.  
  7743.                                 alchemy sample.bif -g
  7744.  
  7745.                            The height of the image will be automatically
  7746.                            calculated from the length of the file and the
  7747.                            width, header, and planes tags.
  7748.  
  7749.                            A BIF file is treated as an ordinary file, so
  7750.                            all the standard Alchemy commands may be used.
  7751.  
  7752.  
  7753.  
  7754.  
  7755.  
  7756.  
  7757.  
  7758.  
  7759.  
  7760.  
  7761.  
  7762.  
  7763.  
  7764.  
  7765.  
  7766.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     E-3
  7767.  
  7768.  
  7769.  
  7770.  
  7771.  
  7772.                                                                           F
  7773.  
  7774.  
  7775.  
  7776.           HSI Raw Files
  7777.           -----------------------------------------------------------------          -----------------------------------------------------------------
  7778.  
  7779.  
  7780.           History          The HSI Raw format was originally intended as an
  7781.                            internal format to Image Alchemy.  Because of
  7782.                            user demand the format has been documented to
  7783.                            allow others to read and write HSI Raw files.
  7784.  
  7785.           Overview         HSI Raw files are completely uncompressed,
  7786.                            unpacked, and unpadded image data files.
  7787.                            Therefore they tend to be larger than almost any
  7788.                            compressed file format.  However, they have the
  7789.                            advantage, as far as Alchemy is concerned, that
  7790.                            they are very fast to read and write and the
  7791.                            location of any pixel in the image may be found
  7792.                            by simple calculations.
  7793.  
  7794.                            If you need to convert custom files to a format
  7795.                            that Alchemy can read we recommend using a Raw
  7796.                            file; it is the simplest format to write and the
  7797.                            fastest for Alchemy to read.
  7798.  
  7799.           Variations       There are two types of HSI Raw Files:  paletted
  7800.                            and true colour.  Paletted images are stored one
  7801.                            byte per pixel with a palette at the beginning
  7802.                            of the file.  True colour files are stored three
  7803.                            bytes per pixel.
  7804.  
  7805.                Gray-scale  Gray scale files are stored as paletted files
  7806.                            with a palette that contains all gray values.
  7807.                            Alchemy automatically recognizes such files
  7808.                            during reading and will treat them
  7809.                            appropriately.
  7810.  
  7811.           Black and white  Black and White files are stored as paletted
  7812.                            files with a palette that contains two values,
  7813.                            black and white.  Alchemy automatically
  7814.                            recognizes such files during reading and will
  7815.                            treat them appropriately.
  7816.  
  7817.  
  7818.  
  7819.  
  7820.  
  7821.  
  7822.  
  7823.  
  7824.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     F-1
  7825.  
  7826.  
  7827.  
  7828.           Warning          Note that Handmade Software, Inc. reserves the
  7829.                            right to make changes to this format at any time
  7830.                            and without notice.  And while it is unlikely,
  7831.                            it is possible that future versions of Image
  7832.                            Alchemy will not support this format.
  7833.  
  7834.           Old version      This appendix describes version 4 Raw files.
  7835.           files            This is the version that Image Alchemy has
  7836.                            written since March 1991.  Before this Alchemy
  7837.                            wrote version 2 and 3 raw files (version 2 were
  7838.                            8 bit files, version 3 were 24 bit files).
  7839.                            Those raw files can be read by current versions
  7840.                            of Image Alchemy but are not otherwise
  7841.                            supported.  If you run across any of these raw
  7842.                            files the easiest thing to do is to use a
  7843.                            current copy of Alchemy to convert them to a
  7844.                            version 4 raw file.
  7845.  
  7846.  
  7847.  
  7848.           Details
  7849.  
  7850.                 Word size  All values which are not otherwise identified
  7851.                            are two byte integers (16 bits).  This is the
  7852.                            native integer size of most IBM PC C-compilers
  7853.                            but not for Macintosh and Sun C-compilers.
  7854.  
  7855.                Byte order  All integers are stored high byte first (big-
  7856.                            endian order).  This is the native mode for
  7857.                            Macintosh's and Sun's but not the native mode
  7858.                            for IBM PC's.
  7859.  
  7860.                            See below for a CPU independent method to read
  7861.                            and write 2-byte integers.
  7862.  
  7863.              Pixel format  Paletted files are stored one byte per pixel.
  7864.  
  7865.                            True colour files are stored as three bytes per
  7866.                            pixel in red, green, blue order.
  7867.  
  7868.                   Padding  Neither the palette information nor the pixel
  7869.                            data is padded to anything other than a byte
  7870.                            boundary.  This means that if you store a file
  7871.                            which is 13 by 11 pixels it will occupy 429
  7872.                            bytes if stored as a true colour file (not
  7873.                            including the header), or 143 bytes if stored as
  7874.                            a paletted file (not including the header and
  7875.                            palette data).
  7876.  
  7877.  
  7878.  
  7879.  
  7880.  
  7881.  
  7882.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     F-2
  7883.  
  7884.  
  7885.  
  7886.                       Hex  Numbers including a 0x prefix are hex; all other
  7887.                            numbers are decimal.
  7888.  
  7889.  
  7890.  
  7891.           File format      The header for a paletted file is 32 bytes plus
  7892.                            the size of the palette.  The header for a true
  7893.                            colour file is exactly 32 bytes (a true colour
  7894.                            file contains no palette).
  7895.  
  7896.              Magic number  Six bytes used to identify the file as a HSI Raw
  7897.                            file:
  7898.  
  7899.                                 0x6d 0x68 0x77 0x61 0x6e 0x68
  7900.  
  7901.                   Version  An integer used to identify the version HSI
  7902.                            file:
  7903.  
  7904.                                 0x0004
  7905.  
  7906.                     Width  An integer indicating the width of the image (in
  7907.                            pixels).
  7908.  
  7909.                    Height  An integer indicating the height of the image
  7910.                            (in pixels).
  7911.  
  7912.              Palette size  An integer indicating the number of entries in
  7913.                            the palette.  Range is 2 to 256.  A 0 indicates
  7914.                            a true colour image (which has no palette data).
  7915.  
  7916.            Horizontal DPI  An integer indicating the horizontal resolution
  7917.                            of the image, in dots per inch.  A zero
  7918.                            indicates that the resolution is unknown.  A
  7919.                            negative number is used if only the aspect ratio
  7920.                            is known.
  7921.  
  7922.              Vertical DPI  An integer indicating the vertical resolution of
  7923.                            the image, in dots per inch.  A zero indicates
  7924.                            that the resolution is unknown.  A negative
  7925.                            number is used if only the aspect ratio is
  7926.                            known.
  7927.  
  7928.                     Gamma  An integer indicating the gamma of the image,
  7929.                            scaled by 100 (a gamma of 2.2 is stored as 220).
  7930.                            A zero indicates that the gamma is not known.
  7931.  
  7932.                  Reserved  Twelve bytes reserved for future use.  Should be
  7933.                            set to zero when writing.
  7934.  
  7935.  
  7936.  
  7937.  
  7938.  
  7939.  
  7940.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     F-3
  7941.  
  7942.  
  7943.  
  7944.                   Palette  The palette data is stored as 3 bytes per
  7945.                            palette entry.  The bytes are in red, green,
  7946.                            blue order; 0 is black, 0xff is full intensity.
  7947.  
  7948.                            True colour raw files have no palette.
  7949.  
  7950.                Image data  The image data.
  7951.  
  7952.  
  7953.  
  7954.  
  7955.  
  7956.  
  7957.  
  7958.  
  7959.  
  7960.           Example files
  7961.  
  7962.           8 bit paletted,  6D 68 77 61 6E 68 00 04  01 40 00 C8 01 00 00 00
  7963.                320 x 200:  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00
  7964.                            49 24 24 24 00 00 00 00  00 DB 6D 6D FF 92 92 FF
  7965.                            B6 B6 92 49 49 FF DB DB  FF B6 92 FF FF DB FF DB
  7966.                            B6 FF FF FF B6 6D 6D 6D  24 24 DB 92 6D 6D 49 49
  7967.                            ...
  7968.  
  7969.  
  7970.               24 bit true  6D 68 77 61 6E 68 00 04  01 40 00 C8 00 00 00 00
  7971.                   colour,  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00
  7972.                320 x 200:  49 24 24 49 24 24 49 24  24 49 24 24 49 24 24 49
  7973.                            24 24 49 24 24 49 24 24  49 24 24 49 24 24 49 24
  7974.                            24 49 24 24 49 24 24 49  24 24 49 24 24 49 24 24
  7975.                            ...
  7976.  
  7977.  
  7978.           Reading a two
  7979.           byte integer
  7980.                                 int putWord(int i, FILE *stream) {
  7981.                                    putc(i>>8, stream);
  7982.                                    return(putc(i&0xff, stream));
  7983.                                 }
  7984.  
  7985.           Writing a two
  7986.           byte integer
  7987.                                 int getWord(int i, FILE *stream) {
  7988.                                    register int temp;
  7989.                                    temp=getc(stream)<<8;
  7990.                                    return(getc(stream) | temp);
  7991.                                 }
  7992.  
  7993.  
  7994.  
  7995.  
  7996.  
  7997.  
  7998.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     F-4
  7999.  
  8000.  
  8001.  
  8002.  
  8003.  
  8004.                                                                           G
  8005.  
  8006.  
  8007.  
  8008.           Undercolour Removal Files
  8009.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8010.  
  8011.  
  8012.           Summary          Undercolour removal files are text files which
  8013.                            control the conversion from RGB to CMYK colour
  8014.                            space.
  8015.  
  8016.                            This conversion consists of four steps.  The
  8017.                            first is to convert an RGB value to an ideal CMY
  8018.                            value; this simply involves negating the RGB
  8019.                            values.  The next step is to determine how much
  8020.                            black is in that colour; this is done by finding
  8021.                            the minimum of the CMY values and using that as
  8022.                            an index into the black removal tables
  8023.                            documented below.  These tables have independent
  8024.                            values for how much black to use for that pixel
  8025.                            and how much black to subtract from the CMY
  8026.                            values.  Next, a linear transform is optionally
  8027.                            applied to the CMY portion of the CMYK pixel.
  8028.                            Finally the CMYK values are optionally
  8029.                            translated, independently, through the CMYK
  8030.                            density correction tables (this last step is
  8031.                            only used if Alchemy is going to dither the
  8032.                            image for output on a 1 bit per pixel per
  8033.                            component device).
  8034.  
  8035.           File format      Any line beginning with ';' is a comment and is
  8036.                            ignored.
  8037.  
  8038.             Black removal  The first 256 non-comment lines contain
  8039.                    tables  undercolour removal values corresponding to
  8040.                            computed black values of 0 (white) to 255
  8041.                            (black).  Each of these lines has two numbers;
  8042.                            the first indicates how much black to use in
  8043.                            place of the computed black value corresponding
  8044.                            to the line, and the second indicates how much
  8045.                            black to subtract from the cyan, magenta, and
  8046.                            yellow components (this value must not be
  8047.                            greater than the corresponding computed black
  8048.                            value).
  8049.  
  8050.                            After the black removal block the remaining
  8051.                            blocks may appear in any order:
  8052.  
  8053.  
  8054.  
  8055.  
  8056.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     G-1
  8057.  
  8058.  
  8059.  
  8060.                CMY linear  If there is a line which says only "HSI CMY
  8061.                 transform  matrix" then the next 3 non-comment lines
  8062.                            contain a matrix representing a linear transform
  8063.                            which is applied to the cyan, magenta, and
  8064.                            yellow components after black removal and before
  8065.                            applying the density map.  The entries are
  8066.                            normalized around 256.  The first row and column
  8067.                            represent cyan, the second magenta, and the
  8068.                            third yellow.  The rows are multiplied by the
  8069.                            input cyan, magenta, and yellow values to create
  8070.                            the corrected values.  A matrix of
  8071.  
  8072.                                 256   0   0
  8073.                                   0 256   0
  8074.                                   0   0 256
  8075.  
  8076.                            is equivalent to omitting the matrix and causes
  8077.                            no correction to take place.  In this case it
  8078.                            would be preferable to omit the matrix as the
  8079.                            conversion will run slightly faster without it.
  8080.  
  8081.              CMYK density  If there is a line which says only "HSI CMYK
  8082.                correction  density map" then the next 256 non-comment lines
  8083.                    tables  contain density correction tables, corresponding
  8084.                            to cyan, magenta, yellow, and black values of 0
  8085.                            (white) to 255.  Each of these lines has four
  8086.                            numbers representing, in order, the amount of
  8087.                            cyan, magenta, yellow, and black to use in place
  8088.                            of the corresponding computed values.  These
  8089.                            tables are only applied during dithering; they
  8090.                            will not be used for those CMYK output formats
  8091.                            which are continuous tone, as devices which take
  8092.                            continuous tone input data should be doing their
  8093.                            own correction.
  8094.  
  8095.           Example          The following undercolour removal file has
  8096.                            undercolour removal tables, CMYK density
  8097.                            correction tables, and a CMY colour correction
  8098.                            matrix.
  8099.  
  8100.                                 ; Undercolour removal file
  8101.                                 ;
  8102.                                   0   0
  8103.                                   1   1
  8104.                                   1   1
  8105.                                   2   2
  8106.                                   3   3
  8107.                                 ... (256 entries total)
  8108.                                 169 169
  8109.                                 169 169
  8110.                                 170 170
  8111.                                 ;
  8112.  
  8113.  
  8114.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     G-2
  8115.  
  8116.  
  8117.  
  8118.                                 HSI CMY matrix
  8119.                                 ;the following matrix leaves the
  8120.                                 ; Cyan and Yellow planes alone, and
  8121.                                 ; subtracts a bit from the Magenta
  8122.                                 ; plane when there's Cyan present.
  8123.                                 ;
  8124.                                 256   0   0
  8125.                                 -32 256   0
  8126.                                   0   0 256
  8127.                                 ;
  8128.                                 HSI CMYK density map
  8129.                                 ;
  8130.                                   0   0   0   0
  8131.                                   0   0   0   0
  8132.                                   0   0   0   0
  8133.                                   0   0   0   0
  8134.                                 ... (256 entries total)
  8135.                                 246 246 246 246
  8136.                                 248 248 248 248
  8137.                                 251 251 251 251
  8138.                                 253 253 253 253
  8139.                                 255 255 255 255
  8140.  
  8141.  
  8142.  
  8143.  
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.  
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     G-3
  8173.  
  8174.  
  8175.  
  8176.  
  8177.  
  8178.                                                                           H
  8179.  
  8180.  
  8181.  
  8182.           PAL Files
  8183.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8184.  
  8185.  
  8186.           Overview         PAL files are text files which contain a palette
  8187.                            in an ASCII form.  Alchemy can extract palettes
  8188.                            from other file formats and write PAL files.
  8189.                            Alchemy can also use PAL files when converting
  8190.                            images.
  8191.  
  8192.           File format      The first line contains the letters "PAL"; this
  8193.                            identifies the file as a palette file.
  8194.  
  8195.                            The next line contains an integer indicating the
  8196.                            number of palette entries.  Valid values are 2
  8197.                            through 256.
  8198.  
  8199.                            The rest of the file consists of lines of 3
  8200.                            numbers each (separated by spaces) representing
  8201.                            the red, green, and blue values for each of the
  8202.                            colours.  These have a range of 0 (black) to 255
  8203.                            (full intensity).
  8204.  
  8205.           Example
  8206.                                 PAL
  8207.                                 8            ;# colours
  8208.                                   0   0   0  ;black
  8209.                                 255   0   0  ;bright red
  8210.                                   0 128   0  ;dark green
  8211.                                 255 255   0  ;yellow
  8212.                                   0   0 255  ;blue
  8213.                                 255   0 255  ;magenta
  8214.                                  63  63  63  ;gray
  8215.                                 255 255 255  ;white
  8216.  
  8217.  
  8218.  
  8219.  
  8220.  
  8221.  
  8222.  
  8223.  
  8224.  
  8225.  
  8226.  
  8227.  
  8228.  
  8229.  
  8230.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     H-1
  8231.  
  8232.  
  8233.  
  8234.  
  8235.  
  8236.                                                                           I
  8237.  
  8238.  
  8239.  
  8240.           Version History
  8241.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8242.  
  8243.  
  8244.           Version 1.5      Released for Sun SPARC, Sun-3, and MS-DOS.
  8245.           10/91
  8246.                    Format  Disabled JPEG arithmetic coding pending
  8247.                            resolution of patent issues.
  8248.                            Added optimum Huffman table generation for JPEG
  8249.                            compression.
  8250.                            Increase in JPEG compression and decompression
  8251.                            speed.
  8252.                            JFIF compatibility verified with Radius, Xing
  8253.                            Technology, and the PDJPEG group.
  8254.                            Reduced memory requirements when reading GIF
  8255.                            files.
  8256.                            The background colour value in GIF files is now
  8257.                            set to the darkest colour in the image.
  8258.                            Added 24 bit PCX support.
  8259.                            Added support for many additional types of
  8260.                            incorrect TIFF files.
  8261.                            Added numerous new file formats, including
  8262.                            Vivid, MTV, DCX, QDV, Erdas, QRT, GEM, Utah RLE,
  8263.                            ADEX, RTL, WPG, Pictor, Autologic, q0, BIF,
  8264.                            Stork, XWD, Scodl, and XBM.
  8265.  
  8266.                   Display  Added support for VESA compatible SVGA boards.
  8267.                            Added support for Sierra HiColor DAC.
  8268.  
  8269.                      Misc  Improved documentation.
  8270.                            Added high quality image scaling.
  8271.                            Added aspect ratio preservation flag for
  8272.                            scaling.
  8273.                            Added wildcard support.
  8274.                            Added support for 15 bits per pixel true colour,
  8275.                            including dithering 24->15 bpp.
  8276.                            Added serpentine raster and noise to dithering.
  8277.                            Added quiet flag.
  8278.                            Added option to not add extension to file names.
  8279.                            Added option to force use of minimum memory.
  8280.                            Added Spiff contrast enhancement.
  8281.                            Added undercolour removal control file for CMYK
  8282.                            formats.
  8283.  
  8284.  
  8285.  
  8286.  
  8287.  
  8288.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     I-1
  8289.  
  8290.  
  8291.  
  8292.                Bugs fixed  Reading and writing Group III and IV TIFF files.
  8293.                            Reading JFIF files with thumbnails.
  8294.                            Reading 24 bit BMP files.
  8295.                            Writing 24 bit PICT files.
  8296.                            Reading uncompressed PICTs.
  8297.                            Reading PICTs with DPI!=72.
  8298.                            Writing 24 bit EPS files.
  8299.                            Reading and writing RLE BMP files.
  8300.                            Reading and writing very large images on Sun-3s
  8301.                            and Sun-4s.
  8302.                            Writing DPI values correctly in ILBM files.
  8303.                            -E option wasn't forcing 16 colours.
  8304.  
  8305.  
  8306.  
  8307.           Version 1.4      Released for Sun SPARC, Sun-3, and MS-DOS.
  8308.           03/18/91
  8309.  
  8310.                    Format  Added Arithmetic coding and decoding for JPEG
  8311.                            compression.
  8312.                            Added 1 bit PCX file support.
  8313.                            Added new compression types to Targa.
  8314.                            Added PBM/PGM/PPM support.
  8315.                            Added GIF89A support for reading.
  8316.                            Added SGI support.
  8317.                            Added Windows BMP support.
  8318.                            Added writing Group III, Group IV, PICIO, and
  8319.                            SGI RLE Tiff compression types.
  8320.                            Added Encapsulated PostScript output.
  8321.                            Added HP PCL support.
  8322.  
  8323.  
  8324.                   Display  Added support for Video 7, Trident, Tseng 4000,
  8325.                            and IBM 8514/A display boards.
  8326.                            Added 320x200x256 display mode.
  8327.                            Added image scaling during display (which allows
  8328.                            display of the entire image on the screen and
  8329.                            preserves aspect ratio).
  8330.                            Images are centered on screen during display.
  8331.                            Before image display the screen is cleared to
  8332.                            the darkest colour.
  8333.  
  8334.  
  8335.  
  8336.  
  8337.  
  8338.  
  8339.  
  8340.  
  8341.  
  8342.  
  8343.  
  8344.  
  8345.  
  8346.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     I-2
  8347.  
  8348.  
  8349.  
  8350.                      Misc  Added image scaling.
  8351.                            Added conversion to monochrome images.
  8352.                            Preserve and allowing specifying of image aspect
  8353.                            ratio or resolution.
  8354.                            Added false colour palette conversion.
  8355.                            Added optimized EGA image generation support.
  8356.                            Added support for very large images.
  8357.                            Added palette sorting, paletted swapping, and
  8358.                            palette selection parameters.
  8359.                            Added Stucki and Jarvis, Judice, & Ninke
  8360.                            Dithering.
  8361.  
  8362.  
  8363.                Bugs fixed  Writing certain 1 bit Sun Raster files.
  8364.                            Reading incorrectly written PCX files.
  8365.                            Reading 24 bit RLE compressed Sun Raster files.
  8366.                            Reading incorrectly written ILBM files.
  8367.  
  8368.  
  8369.  
  8370.           Version 1.3      Released for Sun SPARC and MS-DOS.
  8371.           02/05/91
  8372.                   Formats  Reading Sun Run-Length-Encoded (RLE) files.
  8373.                            Added reading support for interleaved GIF files.
  8374.                            Added 8 bit RAW files.
  8375.                            Added optional smoothing on JPEG reading.
  8376.                            Added support for any colour component sub-
  8377.                            sampling on JPEG reading.
  8378.                            Targa files are now written bottom-up to make
  8379.                            other Targa software happy.
  8380.                            Added palette matching and PAL files.
  8381.  
  8382.                   Display  Added checking for supported VGA boards, warning
  8383.                            if board is recognized but not supported.
  8384.  
  8385.                      Misc  Made memory use more efficient (requiring less
  8386.                            virtual memory on Suns and less overlay swapping
  8387.                            on PCs).
  8388.                            Numerous miscellaneous performance improvements,
  8389.                            (dramatic for some conversions; hardly
  8390.                            noticeable for others).
  8391.  
  8392.                Bugs fixed  Reading and writing 8 bit Sun Raster files which
  8393.                            have an odd width.
  8394.                            Temporary files are now removed when program
  8395.                            exits because of an error.
  8396.  
  8397.  
  8398.  
  8399.  
  8400.           Version 1.2      First release for Sun SPARC systems.
  8401.           01/16/91
  8402.  
  8403.  
  8404.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     I-3
  8405.  
  8406.  
  8407.  
  8408.                Bugs fixed  Fixed several minor bugs (primarily aesthetic).
  8409.                            Made PCX file identifying and reading more
  8410.                            robust.
  8411.  
  8412.  
  8413.           Version 1.1      First release for MS-DOS.
  8414.           01/14/91
  8415.  
  8416.  
  8417.  
  8418.  
  8419.  
  8420.  
  8421.  
  8422.  
  8423.  
  8424.  
  8425.  
  8426.  
  8427.  
  8428.  
  8429.  
  8430.  
  8431.  
  8432.  
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.  
  8439.  
  8440.  
  8441.  
  8442.  
  8443.  
  8444.  
  8445.  
  8446.  
  8447.  
  8448.  
  8449.  
  8450.  
  8451.  
  8452.  
  8453.  
  8454.  
  8455.  
  8456.  
  8457.  
  8458.  
  8459.  
  8460.  
  8461.  
  8462.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     I-4
  8463.  
  8464.  
  8465.  
  8466.  
  8467.  
  8468.                                                                           J
  8469.  
  8470.  
  8471.  
  8472.           Acknowledgments
  8473.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8474.  
  8475.  
  8476.           Summary          Almost all the software which comprises Image
  8477.                            Alchemy was written in house.  However the TIFF
  8478.                            and 640x400 SVGA display modules are
  8479.                            modifications of software originally written by
  8480.                            other people.
  8481.  
  8482.                            Both of these modules are free for anyone's use
  8483.                            as long as proper credit is given as to the
  8484.                            origin of the software.
  8485.  
  8486.  
  8487.                      TIFF  Image Alchemy's TIFF I/O is based on libtiff
  8488.                            which is copyright by Sam Leffler and is used
  8489.                            with his permission.  If you are interested in
  8490.                            reading or writing TIFF files we strongly
  8491.                            suggest that you start with libtiff.
  8492.  
  8493.                            Libtiff is available by anonymous ftp as
  8494.                            ucbvax.berkeley.edu:pub/tiff/*.tar.Z or
  8495.                            uunet.uu.net:graphics/tiff.tar.Z.
  8496.  
  8497.                            If you can not get a copy of libtiff via
  8498.                            anonymous ftp please contact us for a free copy.
  8499.  
  8500.  
  8501.               VGA display  Image Alchemy's 640x400 SVGA display routines
  8502.                            are based on VGAKIT, written by John Bridges.
  8503.  
  8504.                            VGAKIT is available free of charge from a
  8505.                            variety of bulletin boards
  8506.  
  8507.                            If you can not find VGAKIT locally please
  8508.                            contact us for a free copy.
  8509.  
  8510.  
  8511.  
  8512.  
  8513.  
  8514.  
  8515.  
  8516.  
  8517.  
  8518.  
  8519.  
  8520.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     J-1
  8521.  
  8522.  
  8523.  
  8524.  
  8525.  
  8526.                                                                           K
  8527.  
  8528.  
  8529.  
  8530.           Other Useful Software
  8531.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8532.  
  8533.  
  8534.           Summary          There are several image processing packages
  8535.                            available for little or no cost.
  8536.  
  8537.                            Please be aware that we mention these software
  8538.                            packages only as a service to Image Alchemy
  8539.                            users.  We are not endorsing or recommending any
  8540.                            particular package.  Many of the packages are
  8541.                            not supported by their authors.
  8542.  
  8543.                            If you have trouble finding any of the listed
  8544.                            software please send us a blank tape or diskette
  8545.                            and we will send you a copy free of charge
  8546.                            (please be aware that the software may be quite
  8547.                            large; contact us first if you have any
  8548.                            questions).
  8549.  
  8550.                            If you know of any other software which would be
  8551.                            appropriate to add to this list please let us
  8552.                            know.
  8553.  
  8554.                            If you are the author of any of these packages
  8555.                            and you would rather not be on this list please
  8556.                            let us know.
  8557.  
  8558.  
  8559.  
  8560.  
  8561.  
  8562.           IBM PC
  8563.  
  8564.                    PicLab  A public-domain image file conversion and
  8565.                            printing tool.
  8566.                            Written by Lee Crocker and the Stone Soup Group.
  8567.                            Available via CompuServe.
  8568.  
  8569.                     Cshow  A shareware image viewing program.
  8570.                            Written by Bob Berry.
  8571.                            Available from:
  8572.                               Canyon State Systems and Software
  8573.                               PO Box 86
  8574.                               Sedona, AZ  86336
  8575.  
  8576.  
  8577.  
  8578.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     K-1
  8579.  
  8580.  
  8581.  
  8582.                     Vivid  A shareware ray-tracing program.
  8583.                            Written by Stephen B. Coy
  8584.                            Available from:
  8585.                               Stephen Coy
  8586.                               15205 NE 13th Pl., #2904
  8587.                               Bellevue, WA  98007
  8588.  
  8589.  
  8590.  
  8591.           Workstations     These programs are only available as source code
  8592.                            and generally require a workstation running UNIX
  8593.                            or one of its variants.
  8594.  
  8595.               Utah Raster  Written by Spencer W. Thomas, Rod G. Bogart, and
  8596.             Toolkit (URT)  James Painter.
  8597.                            Available via anonymous FTP as pub/urt-3.0.tar.Z
  8598.                            via anonymous ftp from cs.utah.edu,
  8599.                            weedeater.math.yale.edu, or
  8600.                            freebie.engin.umich.edu.
  8601.  
  8602.  
  8603.  
  8604.              Fuzzy Bitmap  Written by Michael Mauldin
  8605.              Manipulation  Available by anonymous ftp as
  8606.                     (FBM)  nl.cs.cmu.edu:/usr/mlm/ftp/fbm.tar.Z,
  8607.                            uunet.uu.net:pub/fbm.tar.Z, or
  8608.                            ucsd.edu:graphics/fbm.tar.Z.
  8609.  
  8610.           Portable BitMap  Written by Jef Poskanzer
  8611.                 (PBMPLUS)  Available by anonymous ftp as
  8612.                            expo.lcs.mit.edu:contrib/pbmplus.tar.Z or
  8613.                            ftp.ee.lbl.gov:pbmplus.tar.Z.
  8614.  
  8615.              Img Software  Written by Paul Raveling
  8616.                       Set  Available by anonymous ftp as
  8617.                            expo.lcs.mit.edu:contrib/img_1.3.tar.Z or
  8618.                            venera.isi.edu:pub/img_1.3.tar.Z.
  8619.  
  8620.  
  8621.  
  8622.  
  8623.  
  8624.  
  8625.  
  8626.  
  8627.  
  8628.  
  8629.  
  8630.  
  8631.  
  8632.  
  8633.  
  8634.  
  8635.  
  8636.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.     K-2
  8637.  
  8638.  
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.  
  8645.  
  8646.           Glossary
  8647.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8648.  
  8649.  
  8650.             Anonymous FTP  An easy way to transfer files via the Internet.
  8651.                            If you don't have Internet access you can't use
  8652.                            anonymous FTP; if you do have Internet access
  8653.                            you probably already know about it (if you
  8654.                            don't, ask your system administrator or local
  8655.                            network guru).
  8656.  
  8657.           Black and white  An image which contains just two colours, black
  8658.                            and white.  Many file formats, such as TIFF and
  8659.                            Sun Raster, have special variations for black
  8660.                            and white images.  You can force Alchemy to
  8661.                            write a black and white image by specifying
  8662.                            -b -c2 as options.
  8663.  
  8664.                 Dithering  A technique for reducing the amount of colour
  8665.                            banding in an image when converting from a large
  8666.                            number of different colours to a small number of
  8667.                            different colours.  Different dithering
  8668.                            techniques are usually named after the person or
  8669.                            persons who first invented them.  Alchemy
  8670.                            supports Floyd-Steinberg, Stucki, and JJN
  8671.                            dithering; these are further described in
  8672.                            "Digital Halftoning", by Robert Ulichnet, MIT
  8673.                            Press.
  8674.  
  8675.                Gray-scale  An image which contains just shades of gray.
  8676.                            Many file formats, such as TIFF and Silicon
  8677.                            Graphics, have special variations for gray-scale
  8678.                            images.  You can force Alchemy to write a gray-
  8679.                            scale image by specifying -b -8 as options.
  8680.  
  8681.  
  8682.  
  8683.  
  8684.  
  8685.  
  8686.  
  8687.  
  8688.  
  8689.  
  8690.  
  8691.  
  8692.  
  8693.  
  8694.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc. Gloss-1
  8695.  
  8696.  
  8697.  
  8698.                    Header  The portion of an image file that is not the
  8699.                            actual image data.  The data in a header
  8700.                            generally includes the image size (in pixels),
  8701.                            the image depth (in number of bits per pixel or
  8702.                            number of colours), and the palette (if the
  8703.                            image has a palette).  Some file formats include
  8704.                            quite a bit of additional data in the header,
  8705.                            such as:  the name of the image, the date and
  8706.                            time the image was created, and the latitude and
  8707.                            longitude of the image (primarily used by
  8708.                            satellite image data).  The header is called the
  8709.                            header because it usually appears at the head of
  8710.                            the file.  Some file formats store information
  8711.                            which is usually found in the header in a
  8712.                            separate file.
  8713.  
  8714.           Heckbert colour  A technique for reducing the number of colours
  8715.              quantization  needed by an image, typically used to convert a
  8716.                            true colour image to a paletted image.  Named
  8717.                            after Paul Heckbert who originally described the
  8718.                            technique in "Color Image Quantization for Frame
  8719.                            Buffer Display", SIGGRAPH '82 Proceedings, p.
  8720.                            297.
  8721.  
  8722.              Magic Number  A number or sequence of numbers that is found at
  8723.                            or near the start of an image file so that
  8724.                            software may determine what type of format the
  8725.                            file is.  Most formats have a well defined magic
  8726.                            number; some formats do not, in which case
  8727.                            Alchemy examines various parameters in the
  8728.                            header of the file and guesses what format the
  8729.                            image is.
  8730.  
  8731.                  Paletted  An image which isn't true colour.  Each pixel in
  8732.                            the image is an index into a table of values
  8733.                            (typically red, green, and blue) which describe
  8734.                            the colour of that pixel.  Most paletted images
  8735.                            are limited to 8 bits of information, which
  8736.                            allows 256 unique colours.  Most display
  8737.                            adapters only allow the display of paletted
  8738.                            images (Alchemy can display true colour images
  8739.                            on those display adapters by using a uniform
  8740.                            palette).
  8741.  
  8742.               True colour  An image which does not contain a palette.  Each
  8743.                            pixel in the image is represented by at least
  8744.                            three values, typically red, green, and blue.
  8745.                            True colour images are generally produced by
  8746.                            scanners and digitizers and are better quality
  8747.                            and much larger than paletted images.  Most
  8748.                            display systems can not display true colour
  8749.                            images.
  8750.  
  8751.  
  8752.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc. Gloss-2
  8753.  
  8754.  
  8755.  
  8756.  
  8757.  
  8758.  
  8759.  
  8760.  
  8761.  
  8762.           References
  8763.           -----------------------------------------------------------------          -----------------------------------------------------------------
  8764.  
  8765.  
  8766.           General Computer Computer Graphics - Principles and Practice,
  8767.           Graphics         Second Edition
  8768.                            (Commonly referred to as Foley and van Dam)
  8769.                            J.D. Foley, A. van Dam, S.K. Feiner, and J.F.
  8770.                            Hughes
  8771.                            Addison-Wesley
  8772.                            ISBN 0-201-12110-7
  8773.  
  8774.                            Principles of Interactive Computer Graphics
  8775.                            (Commonly referred to as Newman and Sproull)
  8776.                            W.M. Newman and R.F. Sproull
  8777.                            McGraw-Hill
  8778.                            ISBN 0-07-046338-7
  8779.  
  8780.                            Algorithms for Graphics and Image Processing
  8781.                            Theo Pavlidis
  8782.                            Computer Science Press
  8783.                            ISBN 0-914894-65-X
  8784.  
  8785.                            Graphics Gems
  8786.                            Andrew S. Glassner
  8787.                            Academic Press
  8788.                            ISBN 0-12-286165-5
  8789.  
  8790.                            Graphics Gems II
  8791.                            James Arvo
  8792.                            Academic Press
  8793.                            ISBN 0-12-064480-0
  8794.  
  8795.                            Bit-Mapped Graphics
  8796.                            Steve Rimmer
  8797.                            Windcrest
  8798.                            ISBN 0-8306-3558-0
  8799.  
  8800.  
  8801.  
  8802.  
  8803.  
  8804.  
  8805.  
  8806.  
  8807.  
  8808.  
  8809.  
  8810.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.   Ref-1
  8811.  
  8812.  
  8813.  
  8814.           Specific Topics
  8815.  
  8816.                    Colour  The Reproduction of Colour in Photography,
  8817.                            Printing & Television
  8818.                            R.W.G. Hunt
  8819.                            Fountain Press
  8820.                            ISBN 0 85242 356 X
  8821.  
  8822.                 Dithering  Digital Halftoning
  8823.                            Robert Ulichnet
  8824.                            MIT Press.
  8825.                            ISBN 0-262-21009-6
  8826.  
  8827.             Image Scaling  Digital Image Warping
  8828.                            George Wolberg
  8829.                            IEEE Computer Society Press Monograph
  8830.                            ISBN 0-8186-8944-7
  8831.  
  8832.           VGA Programming  Programmer's Guide to the EGA and VGA Cards,
  8833.                            Second Edition
  8834.                            Richard F. Ferraro
  8835.                            Addison-Wesley
  8836.                            ISBN 0-201-57025-4
  8837.  
  8838.  
  8839.  
  8840.  
  8841.  
  8842.  
  8843.  
  8844.  
  8845.  
  8846.  
  8847.  
  8848.  
  8849.  
  8850.  
  8851.  
  8852.  
  8853.  
  8854.  
  8855.  
  8856.  
  8857.  
  8858.  
  8859.  
  8860.  
  8861.  
  8862.  
  8863.  
  8864.  
  8865.  
  8866.  
  8867.  
  8868.      Image Alchemy v1.5  Copyright (c) 1990-91 Handmade Software Inc.   Ref-2
  8869.  
  8870.  
  8871.                               Image Alchemy Order Form
  8872.  
  8873.     Qty    Description                                       Price     Total
  8874.  
  8875.  
  8876.     _____  Image Alchemy for MS-DOS (Dual Media)              79.95  __________
  8877.  
  8878.     _____  Image Alchemy/386 for 80386 Protected Mode (3.5") 199.95  __________
  8879.  
  8880.     _____  Image Alchemy/SPARC for Sun (3.5")                199.95  __________
  8881.  
  8882.     _____  Image Alchemy/SPARC for Sun (1/4")                199.95  __________
  8883.  
  8884.     _____  Image Alchemy/6000 for IBM RS/6000 (3.5")         199.95  __________
  8885.  
  8886.     _____  Image Alchemy/Unix for 386 Unix (3.5")            199.95  __________
  8887.  
  8888.  
  8889.                                                           Sub-Total: __________
  8890.  
  8891.                       California Residents add applicable sales tax: __________
  8892.  
  8893.       Shipping and handling       UPS Ground (US only)         4.00
  8894.       (per copy)                  FedEx Second Day (US only)   8.00
  8895.                                   FedEx Overnight (US only)   20.00
  8896.                                   International AirMail       12.00
  8897.                                   International Express Mail  30.00  __________
  8898.                                                                      
  8899.                                                         Total (US$): __________
  8900.  
  8901.  
  8902.     Circle Payment form:       Check      Visa       MC       Amex
  8903.  
  8904.  
  8905.     Card #: _____________________________________     Exp. Date: ______________     
  8906.  
  8907.  
  8908.     Signature: ________________________________________________________________
  8909.  
  8910.  
  8911.     Ship to:                             Bill to:
  8912.     Name: _____________________________  Name: ________________________________
  8913.  
  8914.     Company: __________________________  Company: _____________________________
  8915.  
  8916.     Address: __________________________  Address: _____________________________
  8917.  
  8918.     City: _____________________________  City: ________________________________
  8919.  
  8920.     State: ________  Zip: _____________  State: _________  Zip: _______________
  8921.  
  8922.     Phone: (______)____________________  Fax: (______)_________________________
  8923.  
  8924.     Send to:                                Phone: +1 408 358 1292
  8925.     Handmade Software, Inc.                 Fax:   +1 408 358 2694
  8926.     15951 Los Gatos Blvd., Ste. 17          Email: hsi@netcom.COM
  8927.     Los Gatos, CA  95032                    Email: 71330,3136 (CompuServe)